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There  are  many  types  of  computerized  training  systems  available  today  ranging 
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Additionally,  when  the  information  in  the  framing  material  changes,  a  new  copy  must  be 
created,  distributed  and  installed  before  it  is  available  to  the  end  user. 

This  thesis  explores  the  use  of  the  Java  programming  language  as  a  fundamental 
element  in  the  creation  of  interactive  courseware  deployable  through  the  World  Wide 
Web.  Java  is  used  to  add  interactive,  executable  content  to  Web  pages  in  the  form  of 
simulations  and  complex  demonstrations  of  educational  concepts. 

Complete  online  materials  were  developed  in  support  of  the  initial  offering  of 
CS2973,  a  Java  programming  course.  Following  that  success,  a  prototype  interactive 
online  exam  system,  using  a  Java  applet  and  file  server,  was  developed.  This  prototype 
foreshadows  a  complete  virtual  classroom  environment  supported  by  a  Courseware 
Creation  Interface.  Both  of  these  have  the  distinct  advantage  of  being  cross-platform  by 
virtue  of  being  created  in  the  Java  programming  language,  thus  usable  on  a  majority  of 
operating  systems  and  platforms  through  Java-enhanced  Web  browsers. 
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I.  INTRODUCTION 


Traditional  teaching  materials  typically  include  lecture  notes  and  other  support  in 
the  form  of  video,  audio  and  software.  These  materials  have  traditionally  taken  the  form 
of  handouts  or  overhead  slides.  As  a  result,  once  these  kinds  of  course  materials  are 
produced,  they  are  often  duplicated  and  require  much  effort  to  modify.  But  suppose  there 
were  an  improved  and  integrated  way  to  view  all  of  these  different  types  of  materials,  and 
moreover,  that  this  could  be  done  with  just  the  click  of  a  mouse  from  anywhere  on  the 
planet!  With  such  technology,  the  opportunity  arises  for  truly  reusable  courseware,  on  a 
global  scale,  where  by  "courseware"  we  mean  the  elecu'onic  representation  of  instructional 
materials.  Such  technology  now  exists  by  virtue  of  the  World  Wide  Web  (WWW). 
A.         THE  WORLD  WIDE  WEB 

The  World  Wide  Web,  was  initially  developed  at  CERN,  a  particle  physics 
laboratory  in  Geneva  Switzerland.  The  initial  work  began  in  1989  and  centered  on  the 
development  of  the  HyperText  Transmission  Protocol  (HTTP),  which  is  a  network 
protocol  for  requesting  and  transmitting  Web  files  and  documents  that  both  Web  servers 
and  browsers  can  understand.  Through  the  early  90s,  CERN  created  tools  to  make  the 
Web  what  it  is  today.  They  developed  a  Web  server,  as  well  as  a  text-based  web  browser 
and  eventually  made  the  server  and  browser  software  freely  available  on  the  Internet. 
[NSM95] 


Tim  Berners-Lee,  initial  creator  of  the  World  Wide  Web  project,  describes  the 

Web  as  follows: 

The  WWW  project  merges  the  techniques  of  information  retrieval 
and  hypertext  to  make  an  easy  but  powerful  global  information  system.  The 
WWW  world  consists  of  documents,  and  links.  Indexes  are  special 
documents  which,  rather  than  being  read,  may  be  searched.  The  result  of 
such  a  search  is  another  (virtual)  document  containing  links  to  the 
documents  found.  The  Web  contains  documents  in  many  formats.  Those 
documents  which  are  hypertext,  (real  or  virtual)  contain  links  to  other 
documents,  or  places  within  documents.  All  documents,  whether  real, 
virtual  or  indexes,  look  similar  to  the  reader  and  are  contained  within  the 
same  addressing  scheme.  To  follow  a  link,  a  reader  clicks  with  a  mouse  (or 
types  in  a  number  if  he  or  she  has  no  mouse).  To  search  an  index,  a  reader 
gives  keywords  (or  other  search  criteria).  These  are  the  only  operations 
necessary  to  access  the  entire  world  of  data.  [NSM95] 

Perhaps  the  main  reason  for  the  rapid  acceptance  and  growth  of  the  Web  was  the 
work  done  at  the  National  Center  for  Supercomputer  Applications  (NCSA)  at  the 
University  of  Illinois  in  Urbana-Champaign.  Their  software  development  group  created  a 
graphical  Web  browser  called  Mosaic.  In  September  1993,  they  released  versions  of 
Mosaic  for  Microsoft  Windows  running  on  PCs,  Apple  Macintoshes  and  Unix  computers 
running  X  Windows.  Each  of  the  versions  handled  files  in  a  very  similar  manner  with 
images  and  text  interspersed  in  the  same  document,  allowing  organizations  to  create 
visually  exciting  documents  that  could  be  viewed  in  very  similar  formats  on  the  three  main 
types  of  computer  in  use  at  that  time.  [NSM951 

Many  members  of  the  team  who  developed  the  original  versions  of  Mosaic  now 
work  for  Netscape  Communications  Corporation,  a  company  which  has  developed  the 
Netscape  Web  browser.  It  is  estimated  that  Netscape  accounted  for  around  70  percent  of 
all  Web  browsers  in  use  in  May  1995.  Following  the  highly  successful  launch  of  Netscape 


Communications,  Microsoft  recognized  the  commercial  potential  of  the  WWW  and 
quickly  developed  the  Internet  Explorer  Web  browser.  Many  other  companies  have  also 
launched  a  range  of  Internet  browsers  and  servers,  further  intensifying  competition  in  the 
Internet  marketplace.  [NSM95] 

B.    EDUCATION  AND  THE  ROLE  OF  THE  WEB 

Until  now,  use  of  the  Web  for  instruction  has  involved  primarily  the  use  of  static 
content  (text  and  images).  Though  somewhat  limited,  static  content  on  the  Web  still  has 
many  advantages.  Some  of  the  advantages  are  that  Web  documents  are  available  to 
anyone  on  the  network  running  a  Web  browser.  This  includes  remote  Internet  sites 
accessible  by  modem.  Web  documents  also  integrate  easily  with  other  network  services 
like  email  and  network  newsgroups.  They  can  be  developed  and  shared  by  many 
institutions  and  companies  for  automated  distance  learning.  Web  documents  can  also  be 
viewed  by  browsers  running  on  many  different  kinds  of  platforms  from  Macintosh  to  Unix 
to  PC  compatibles.  Another  feature  of  Web  documents  is  the  ability  to  have  hypertext 
links  embedded  with  in  Web  documents.  The  hypertext  links  allow  the  Web  page  designer 
to  link  related  Web  pages  to  other  Web  pages.  This  allows  users  who  require  further 
detail  on  a  topic  to  merely  click  on  the  hypertext  link  to  move  to  related  Web  pages.  And 
finally,  many  vendors  offer  a  wide  variety  of  Web  document  generation  tools  that  greatly 
simplify  building  Web  documents. 

In  this  thesis,  we  investigate  the  role  of  the  World  Wide  Web  and  technology,  in 
educational  courseware.  Use  of  the  Web  for  this  purpose  is  facilitated  by  recent  Web 


programming  languages  like  Sun's  Java  and  Microsoft's  Active  X,  and  scripting  languages 
like  Netscape's  JavaScript  and  Microsoft's  Visual  Basic  Script.  These  tools,  coupled  with 
powerful  Web  browsers  and  enhanced  server  Applications  Programming  Interfaces 
(API's),  make  it  possible  to  move  far  beyond  the  traditional  "static"  approaches  to  Web 
content  that  were  popular  just  a  short  time  ago.  They  provide  a  framework  within  which 
one  can  develop  very  flexible  and  interactive  aids  for  online  instruction  and  training. 
Within  the  simplicity  of  a  Web  browser  exists  the  capacity  to  display  textual  data,  play 
audio  streams,  display  animated  graphical  representations  of  data  (e.g.  weather  analysis) 
and  to  engage  the  user  in  interactive  learning  with  simulations  of  any  level  of  complexity. 

C.         LEVELS  OF  WEB  INTERACTION 

We  classify  Web  courseware  roughly  according  to  the  level  of  interaction  it 
provides.  We  consider  the  lowest  level  of  interaction  to  be  that  of  "static  content"  or  static 
Web  pages.  This  is  essentially  hypertext,  implemented  in  Hypertext  Markup  Language 
(HTML)  which  is  a  subset  of  Standard  General  Markup  Language  (SGML).  It  is 
characterized  by  hypertext  links  consisting  of  Uniform  Resource  Locators  (URL's). 
Through  implementations  of  the  simple  GET,  PUT  and  POST  commands  of  the  Hypertext 
Transport  Protocol  (HTTP),  servers  can  provide  the  byte  streams  for  images,  audio  or 
text,  which  we  consider  static. 

At  higher  levels  of  interaction,  we  find  "active  content"  in  Web  pages.  Examples 
include  the  HTTP  features  of  "server-side  includes"  and  Common  Gateway  Interface 
(CGI)  scripts  written  in  Perl  and  C.  With  this  technology  it  is  possible  to  till  out  forms  in 
Web  pages  and  store  their  contents  on  a  server.  CGI  scripts  go  beyond  the  static  model  of 


a  client  issuing  one  HTML  request  after  another.  Instead,  CGI  scripts  allow  the  HTTP 
server  to  send  documents  depending  on  the  client's  request.  Although  useful  for  online 
forms  and  database  queries,  CGI  scripts  are  much  too  awkward  for  serious  courseware 
development.  Since  CGI  scripts  execute  on  the  server,  they  can  lead  to  poor  performance 
when  there  are  many  requests  to  the  server. 

Opportunities  for  high  level  interaction  came  in  1995  with  the  introduction  of 
Sun's  HoJava  Web  browser.  Unlike  its  predecessor,  NCSA  Mosaic,  HotJava  supported 
"active  content"  in  Web  pages  called  Java  Applets.  Active  content  is  basically  executable 
code.  Though  not  originally  targeted  for  the  Web,  Java  turned  out  to  be  extraordinarily 
useful  in  this  setting.  Applets  gave  programmers  a  way  to  bring  life  to  Web  pages  through 
animation  and  simulations.  The  seeds  were  sown  for  exciting  new  ways  to  conduct 
research  and  to  educate  using  the  Web.  Not  surprisingly,  active  content  offers  the  most 
potential  for  developing  effective  online  courseware. 

Active  content  may  take  the  form  of  an  inline  executable  script  or  a  procedure  call, 
via  some  sort  of  tag  in  the  markup  language,  which  runs  within  a  "container"  (or  runtime 
system)  for  the  code.  Our  examples  use  the  Netscape  Navigator  (v2.02)  as  the  container 
in  which  Java  bytecode  is  executed.  However,  the  techniques  we  describe  are  really 
language  and  container  independent.  We  suspect,  although  we  did  not  attempt  it,  that  our 
techniques  could  also  be  applied  to  Active  X  and  Microsoft  Internet  Explorer. 


D.         THESIS  ORGANIZATION 

This  thesis  illustrates  some  of  the  ways  Java  and  active  content  can  be  used  to 
develop  courseware  that,  contains  a  combination  of  hypertext  and  executable  content  in 
documents.  Some  of  the  techniques  described  here  were  used  to  build  courseware  for  the 
Naval  Postgraduate  School  course,  CS2973,  Object-oriented  Programming  for  the 
Internet  with  Java.  It  was  offered  for  the  first  time  by  the  Computer  Science  Department 
in  the  Summer  of  1996.  CS2973  courseware  is  entirely  online,  written  primarily  in  HTML 
with  some  embedded  Java.  We  will  also  describe  some  techniques  that  go  beyond  what 
was  employed  in  CS2973  to  illustrate  the  great  potential  of  Web  technology  for 
instruction. 

Static  content  in  Web  pages  is  considered  in  Chapter  II,  followed  by  active 
content  in  Chapter  III.  In  Chapter  IV,  we  discuss  the  use  of  Java  in  active  courseware. 
The  merits  of  each  are  examined  and  examples  are  given.  Some  examples  are  taken  from 
the  inaugural  offering  of  CS2973.  In  Chapter  V,  we  discuss  future  work  and  in  Chapter 
VI  we  discuss  related  work  and  draw  some  conclusions  about  the  future  of  Web 
technology  in  education. 


II.  STATIC  CONTENT  IN  COURSEWARE 

Static  content  can  be  a  major  component  of  effective  courseware  even  though  it  is  not 
active.  This  kind  of  content  includes  text,  images  and  audio  and  thus  provides  the  rudiments  for 
an  online  textbook.  Of  course,  the  text  or  static  content  in  courseware  is  hypertext,  so  in  this 
sense,  static  content  offers  more  than  ordinary  text.  For  example,  it  allows  for  self-describing 
pictures  using  audio  files. 
A.         HTML  —  THE  GLUE  OF  STATIC  CONTENT 

The  mechanism  one  uses  for  organizing  static  content  into  a  useful  format  is  the  Hypertext 
Markup  Language  (HTML).  In  its  simplest  form,  HTML  "tags"  are  placed  in  plain  text  files  to 
define  the  display  characteristics  of  the  marked  text.  Joint  Photographic  Experts  Group  (JPG) 
and  Graphics  Interchange  Format  (GIF)  images  may  be  embedded  in  the  document  for  inline 
display  with  the  text.  Additionally,  hyperlink  tags,  which  point  to  resources  external  to  the 
document,  can  be  embedded  easily.  When  the  tags  are  interpreted  by  a  Web  browser,  the  text  and 
images  are  formatted  accordingly.  Figure  2.1  lists  the  HTML  code  used  to  generate  the  Web 
page  in  Figure  2.2. 

HTML  is  based  on  formatting  with  respect  to  components  such  as  headings,  paragraphs 

and  lists  The  general  format  for  a  HTML  tag  is 

<tag_name>string   of    text</tag_name> . 
The  entire  HTML  document  is  delimited  by  the  tags 

<HTML>  and  </HTML>. 

As  shown  in  Figure  2.1,  an  HTML  document  contains  two  distinct  parts,  the  head  and  the  body. 
The  head  contains  identifying  information  about  the  document,  such  as  indexing  information  and 
the  title,  and  is  delimited  by  the  tags 


<HEAD>   and   </HEAD>. 
The  body  contains  everything  displayed  as  part  of  the  web  page  and  is  delimited  by 

<BODY>  and  </BODY>. 

Among  the  more  useful  tags  are  the  image  and  hyperlink  anchor  tags.  An  example  of  the  HTML 
code  required  to  embed  an  image  in  the  page  is  the  line 

<IMG   SRC=  "ballgrn.gif  ">. 
The  img  tag  indicates  an  image  and  the  src  value  contains  the  filename  of  the  image.  A  hyperlink 

may  be  embedded  behind  any  text  or  image  displayed  in  the  document  by  using  an  anchor  tag: 

<a  href =".. /course/index. html">    [Previous]    </a> 
which  is  a  link  to  the  URL  of  the  index  page.  One  can  make  an  image  a  hyperlink  by  combining 

the  previous  two  examples  as  in 

<a  href =" . . /course/ index. html ">< IMG   SRC=" . . /graphics/globe.gif " 
ALT= "GLOBE"    align= " right "    ></a>. 

This  example  also  uses  an  alignment  option  and  alternative  text  to  be  used  if  the  browser  does  not 

display  the  image.  HTML  is  discussed  further  in  Appendix  D. 

B.         USING  STATIC  CONTENT  EFFECTIVELY 

Here  we  provide  some  suggestions  for  using  static  web  content  effectively  in  courseware. 
They  are  the  result  of  our  experience  in  developing  the  CS2973  course  content  the  Web.  From 
this  course,  we  learned  some  general  guidelines  for  navigating  Web  documents  and  laying  out 
Web  pages  effectively  in  courseware. 


<HTML> 

<HEAD> 

<TITLE>Homework  Info  </TITLE> 

</HEAD> 

<BODY> 

<a  href =".. /course/ index. html " >  [Previous]  </a> 

<a  href ="hwl .html ">  [Next]  </a> 

<a  href =" index .html ">  [ Index] </a> 

<a  href =" . . /course/ index. html ">< IMG  SRC= " . . /graphics /globe. gi f " 

ALT="GLOBE"  align= " right "  ></a> 

<H1>CS2973  Homework  Info</Hl> 

<IMG  SRC="ballgrn.gif "> 

<A  href  =  "  #setup">Required  WWW  Setup</axBR> 

<IMG  SRC=" ballgrn.gif ">Assignments</a> 

<BR> 

<ul> 

<LIxa  href  =  "hwl  .html" >Homework  l</a><BR> 

<LIxa  href  =  "hw2  .html" >Homework  2</axbr> 

<LIxa  href  =  "hw3  .html" >Homework  3</axbr> 

<LIxa  href  =  "hw4  .html  ">Homework  4</axbr> 

<LIxa  href  =  "hw5  .html  ">Homework  5</axbr> 

</ul> 

<P> 

The  CS2973  homework  exercises  constitute  60%  of  your  final  grade. <BR> 

<B>Critical  items  are  in  bold.</b>  Please  adhere  closely  to  these 

instructions  so  that  all 

of  the  items  are  standardized . <p> 

<h2xname=" setup ">Required  WWW  Setup</h2> 

If  you  do  not  have  one,  <b>create  a  home  page</b>  for  yourself  on  the 

the  NPS  Web  server.  For  more  information  look  at  the  <a  href= 

"http: // vis lab-www. nps .navy.mil/YourOwn.html ">VisLab' s  HowTo  </a> . 

Ensure  that  your  correct  <B>email</B>  address  is  listed  on  the  page.<p> 
<P> 

this  page  is  located  at  <BRxB>http : //vislab- 
www. nps .navy .mil /- java/course/hw. html </BxBR> 
<A 

HREF="mailto:  java@nps  .navy.mil  ( JAVAPage)  "xi>  javaOnps  .navy  .mil</ix/AxE 
R> 
Last  Updated  3  JUL9  6<BR> 

< ! --Copyright-->  &»169  Naval  Postgraduate  School  1996<BR> 
</B0DY> 
</HTML> 


Figure  2.1   HTML  source  code 


C. 


NAVIGATION 


Whether  a  classroom  of  students  is  lead  by  an  instructor  or  an  individual  is  browsing 
independently,  the  usual  path  through  the  material  should  be  obvious  and  direct.  On  the  other 
hand,  examining  related  topics  or  material  should  also  be  encouraged.  This  can  be  facilitated  by 
adopting  the  following  navigation  strategy. 

First,  plan  a  simple,  hierarchical  view  of  the  course  topics  presented  as  an  index  page.  The 
course  topics  can  be  viewed  at  any  level  of  granularity.  For  individual  study,  a  student  may  go  to 


the  topic  of  choice  and  skip  the  introductory  material  altogether.  This  allows  students  to 
customize  their  view  of  the  course  should  they  already  be  familiar  with  some  of  the  material.  It  is 
not  necessary  to  start  from  the  beginning  and  continue  to  the  end  in  a  serial  manner. 

Second,  define  a  clear  path  of  instruction  through  the  material.  The  path  should  consist  of 
the  course  topics  presented  in  logical  order.  Moving  in  either  direction  along  the  path  should  be 
accomplished  by  a  single  mouse  click  on  the  appropriate  hyperlink.  For  example,  the  link 
[Previous]  returns  a  user  to  the  previous  page,  [Next]  takes  a  user  to  the  next  page,  and  [Index] 
returns  the  user  to  the  index  page. 

It  should  also  be  possible  to  explore  a  subject  further  at  any  time.  Returning  to  the 
original  point  will  be  accomplished  by  using  the  "Back"  feature  of  the  browser.  This  allows 
students  to  navigate  through  related  material,  deviating  from  the  main  course  path,  without  the 
problem  of  trying  to  find  their  way  back  to  the  original  page.  If  a  student  wishes  to  back  track  to 
a  previous  page,  then  he  or  she  merely  "clicks  on"  the  "Back"  feature  of  the  browser  until  the 
desired  Web  page  is  displayed. 

D.         PAGE  LAYOUT 

Continuity  plays  an  important  role  in  the  acceptance  of  online  courseware  by  users.  Adopt 
a  template  to  use  as  a  model  for  every  page  in  a  course.  Standard  page  headers  should  include 
navigational  hyperlinks  ([Previous],  [Next],  [Index]),  the  section  number  and  the  title  of  the 
section.  The  footer  includes  navigational  hyperlinks,  contact  information  for  the  page  author, 
creation  date,  and  the  URL  of  the  page  being  viewed.  Standardizing  the  course  page  layout 
enhances  the  presentation  and  makes  future  modifications  easier;  see  Figure  2.2. 


10 


IIIHIIHIMIMi 


Navigation  Links 


Netscape  -  (Homework  Info] 


File     Edit     View     Go     Bookmarks     Options     Directory     Window 
Help 


Locator 


t**~-l-**"-,LfcA**'t"~w-*^^ 


file:  ///H  l/THESI  S  /\a  vahtml/H  WOD 1 3~1 .  H  T  M 


*f** H-+ ■ ^nnmnt**+mfH» 


[Previous]  [Next]  [Index] 


S2973  Homework  Info 


**  Required  WWW  Setup 
^Assignments 

•  Homework  1 

•  Homework  2 

•  Homework  3 

•  Homework  4 

•  Homework  5 

The  CS2973  homework  exercises  constitute  60%  of  your  final  grade. 

Critical  items  are  in  bold.  Please  adhere  closely  to  these  instructions  so  that  all  of 

the  items  are  standardized. 

Required  WWW  Setup 

If  you  do  not  have  one,  create  a  home  page  for  yourself  on  the  the  NPS  Web  server. 
For  more  information  look  at  the  VisLab's  HowTo  .  Ensure  that  your  conect  email 
address  is  listed  on  the  page. 

this  page  is  located  at 

http :  //vislab-www  Jip  s  .navy  jnil/~j  ava/course/hw  Jitml 

Java  (Spips.  navy. mi! 

Last  Updated  8  JUL96 

©  Naval  Postgraduate  School  1996 


~£jM  iDcrcumerikDone 


M 


Figure  2.2  Standard  page  layout 
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III.  ACTIVE  CONTENT  VIA  JAVA 

For  this  thesis,  we  implemented  our  courseware  in  Java  and  executed  it  within  the 
Netscape  browser.  Java  is  an  Object-Oriented  Programming  Language  that  we  chose 
because  of  its  useful  Application  Program  Interfaces  (API)  for  platform-independent 
Graphical  User  Interfaces  (GUIs)  and  network  programming.  Instead  of  generating  binary 
executables,  a  Java  compiler  creates  "bytecode"  which  execute  via  a  Java  interpreter  on 
the  native  system.  Java-enabled  Web  browsers  execute  bytecode  as  the  HTML  document 
is  loaded.  As  such,  Java  enables  the  Web  page  to  contain  small  programs  with  which  the 
user  may  interact.  Though  there  are  numerous  books  on  the  Java  language,  in  this  chapter 
we  will  summarize  the  key  features  of  Java  needed  for  online  courseware.  They  are  the 
Java  Absti-act  Windowing  Toolkit  (AWT),  defined  in  the  java .  awt  package,  and  Java 
networking  tools  defined  in  the  java .  net  package. 
A.         GUI  PROGRAMMING  IN  JAVA  WITH  THE  AWT 

The  AWT  is  a  platform-independent  windowing  toolkit  supporting  many  of  the 
basic  needs  of  a  GUI  (e.g.  windows,  menu  bars,  buttons,  etc).  The  toolkit  is  regarded  as 
abstract  because  it  serves  as  an  interface  between  Java  applications  (and  Applets)  and 
native  GUI  libraries  for  a  given  operating  system.  Details  of  the  underlying  GUI  library, 
which  are  platform-specific,  are  hidden  from  Java  programs.  Because  the  windowing  sub- 
components, buttons,  scrollbars,  menus,  etc.,  are  actually  provided  by  the  native 
windowing  system's  "peer  objects",  there  may  be  slight  layout  and  display  differences 
between  platforms.  For  instance,  the  file  dialogue  display  window  on  the  Macintosh  is 
different  from  that  of  the  file  dialogue  display  window  on  Microsoft  Windows.  In  order 
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for  the  Java  AWT  to  be  portable,  it  must  have  an  interface  developed  for  each  specific 
platform  allowing  the  AWT  to  recognize  the  native  system's  peer  objects.  The  Java 
AWT  provides  the  "highest  common  factor"  of  functionality  across  a  wide  variety  of 
native  windowing  toolkits.  The  AWT's  methods  for  each  platform  are  implemented  by 
SunSoft,  the  makers  of  Java. 

What  does  all  that  mean?  In  essence,  a  given  piece  of  code  written  to  display  a  set 
of  buttons,  labels  or  scrollbars  for  one  platform,  can  be  used  on  a  completely  different 
platform  with  no  changes  in  the  code  because  the  Java  program  calls  the  peer  for  each 
system. 

The  following  example  is  a  simple  "Hello  World"  applet.  It  does  nothing  more 
than  print  the  string  "Hello  World".  The  Java  sourcecode  is  shown  in  Figure  3.1.  The 
init  ( )  method  is  invoked  by  the  browser  when  the  applet  is  initially  loaded  into  the 
browser.  The  Label  object  calls  the  native  peer  of  a  label  and  displays  the  string  "Hello 
World".  The  system  font  "Dialog"  is  specified  with  the  characteristics  of  bold  and  10 
point  size.  This  file  is  compiled  to  create  the  bytecode  file  "hello .  class"  and  is  called 
by  the  HTML  file  "hello. html".  The  minimum  HTML  tags  needed  to  display  an  applet 
are  the  code  parameter,  which  is  the  name  of  the  bytecode  file,  and  the  width  and  height  of 
the  applet  in  pixels.  The  HTML  file  in  Figure  3.2  will  produce  the  output  of  Figure  3.3. 
Though  this  is  a  simple  example,  using  only  the  Label  class  of  the  AWT,  it  illustrates  the 
basic  relationship  between  the  Java  AWT  and  HTML.  The  AWT  is  described  in  more 
detail  in  Appendix  E. 
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import 

] ava . awt . * ; 

public 

class  hello  extends 

3  ava. 

applet . 

Applet 

{ 

Label  labell; 

public  void  init()  { 

label l=new  Label ( " 

Hello 

World") 

i 

labell . setFont (new 

Font  ( 

"Dialog 

" , Font 

BOLD 

10)); 

} 
} 

add (labell) ; 

Figure  3.1  Java  source  code  for  hello.java. 


<HTML> 

<HEAD> 

<TITLE>My  First  Applet</TITLE> 

</HEAD> 

<B0DY> 

<P> 

<APPLET  code="hello. class"  width=150  height=100> 

</APPLET> 

</B0DY> 

</HTML> 


Figure  3.2  hello.html  source  code. 


Netscape  ^[Hello  World] 


File     Edit     View     Go     Bookmarks     Options 
Directory     Window     Help 


Hello  World 


O"? 


Figure  3.3  Snapshot  of  hello.html. 
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B.         THE  NETWORK  API  IN  JAVA 

Java  provides  a  number  of  built-in  networking  capabilities  that  make  it  easy  to 
develop  Web-based  applications.  Java's  networking  capabilities  are  provided  via  the 
j  ava .  net  package.  The  j  ava .  net  package  provides  numerous  powerful  network 
programming  classes  that  simplify  networking,  making  network  programming  with  Java 
flexible  and  easy  to  use  (Figure  3.4).  The  j  ava  .net  package  supports  both  TCP/IP 
(Transport  Connection  Protocol/Internet  Protocol)  and  UDP  (Unreliable  Datagram 
Protocol)  protocol  families. 


Java  net  Package 

Socketimpl 

Cn 

ntentHandler 

URL 

nn 

tag  ram  Packet 

L/U 

URLConnection 

nn 

tagramSocket 

L/Cl 

URLEncoder 

Inr 

jtAddress 

URLStreamHanle 

cf 

jrverSocket 

Socket                         — ' 

Figure  3.4     java.net  Package 

TCP/IP  is  used  for  reliable  stream-based  communication  across  the  Internet.  It 
specifies  the  manner  in  which  two  processes  running  on  different  machines  on  the  Internet 
find  each  other,  rendezvous,  and  transfer  data.  It  makes  sure  data  are  transferred  in  the 
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correct  sequence  and  without  error.  Additionally,  TCP/IP  uses  a  static  addressing  scheme 
where  every  machine  on  the  Internet  is  assigned  a  unique,  fixed  IP  address. 

In  contrast,  UDP  is  used  for  unreliable  datagram  communication;  also  called  "fire- 
and-forget"  packet  transmission  across  the  network.  UDP  is  fast,  but  the  tradeoff  is  that 
the  data  is  not  guaranteed  to  reach  its  destination,  and  separate  datagrams  are  not  even 
guaranteed  to  reach  their  destination  in  the  order  in  which  they  were  sent.  Commu- 
nication with  datagrams  is  useful  when  you  want  low-overhead  communications  of  non- 
critical  data  and  a  stream  model  of  communication  is  not  necessary.    In  this  case,  the 
application  must  reorganize  the  data  into  the  correct  sequence. 

Although  the  java.net  package  is  organized  into  eleven  classes  that  range  from 
the  simple  URL  networking  class  to  the  more  complex  DatagramPacket  class,  we  will 
focus  on  the  features  useful  in  building  courseware.  These  features  allow  the  client  applet 
to  create  socket  connections  to  a  server  and  to  send  and  receive  data. 

The  DatagramPacket  class  implements  an  unreliable  datagram  "packet"  of  data 
that  may  be  sent  or  received  over  the  network  through  a  Datagramsocket. 

The  Datagramsocket  class  defines  a  socket  that  can  receive  and  send  unreliable 
DatagramPacket  class  implementations  over  the  network. 

The  inetAddress  class  represents  an  Internet  address,  and  is  used  when  creating 
DatagramPacket  or  Socket  objects.  This  class  returns  an  array  of  bytes  which  represents 
the  name,  internet  protocol  address,  local  host  name,  and  other  information. 

The  serversocket  class  is  used  by  servers  to  listen  for  socket  connection 
requests  from  clients.  The  socket  class  implements  a  socket  for  interprocess  communica 
tion  over  the  network.  The  constructor  method  creates  the  socket  and  connects  it  to  the 
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specific  host  and  port.  TCP/IP  sockets  are  used  to  implement  reliable,  bi-directional, 
stream-based  connections  between  a  server  and  a  client  on  the  Internet.  In  Java,  TCP/IP 
sockets  are  created  via  the  Socket  class. 

1.  A  Java  Network  Application  —  Course  Server  and  Question  Applet 

Java  provides  socket-based  communications  that  enable  applications  to  view 
network  communications  as  if  they  were  simple  file  input  and  output.  A  program  can  read 
from  a  socket  or  write  to  a  socket  as  simply  as  reading  or  writing  with  a  file.  The  socket 
class  implements  a  reliable  stream  network  connection.  A  common  model  for  networking 
is  to  have  one  or  more  clients  send  requests  to  a  single  server  program.  In  Chapter  IV  we 
describe  a  server  application  and  a  client  applet  which  pass  streams  of  data  via  socket 
connection.  The  sourcecode  will  be  used  as  an  example  here. 

a.  Course  Server 

The  Course  Server  uses  the  serversocket  class  to  accept  connections 
from  clients.  When  a  client  connects  to  the  port  that  a  serversocket  is  listening  on,  the 
server  allocates  a  new  socket  object,  which  is  connected  to  a  defined  port,  for  the  client 
to  communicate  through  (Figure  3.5).  Since  the  Course  Server  is  multithreaded,  it  then 
returns  to  listening  for  other  possible  clients  on  the  serversocket  (Figure  3.6).  See 
Appendix  G  for  a  complete  description  of  the  Course  Server. 


// 

Create  a  Serversocket  to 

listen  for 

connections  on; 

public 

FS3 (int  port)  { 

if  (port  ==  0)  port 

=  DEFAULT. 

PORT; 

this. port  =  port; 

try  {  listen_socket 

=  new  ServerSocke 

t (port) 

;  } 

catch  (IOException  s 

)  { 

fail (e,  " Except ior 

i  creating 

server 

socket " 

)  ;  } 

System . out .println ( " 

FS3 :  listening  on 

port  " 

+port ) ; 

} 

this . start ( ) ; 

Figure  3.5  serversocket  listening  on  socket,  fs3  .  java  source  code 
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// 

The  body  of  the  server  thread.   Loop  forever, 

// 

listening  for  and  accepting  connections  from  clients. 

// 

For  each  connection,  create  a  Connection  object  to 

// 

handle  communication  through  the  new  Socket.   Multiple  Threads. 

public  void  run ( )  { 

try  { 

while (true)  { 

Socket  client_socket  =  listen_socket . accept  () ; 

Connection  c  =  new  Connection (client  socket); 
} 

} 

catch  (IOException  e)  {  fail(e,  "Exception  while  listening 

for  connections"); 

} 
} 

Figure  3.6  serversocket  listening,  spawn  new  socket  upon  connection, 
b.         Question  Applet 

The  Quest  ionApplet  class  implements  a  client  that  communicates  with  the 
Course  Server.  The  Quest  ionApplet  creates  a  socket  object,  as  shown  in  Figure  3.7,  to 
establish  the  connection  to  the  Course  Server.  The  Quest  ionApplet  client  creates  a 
DatalnputStream  to  read  lines  from  the  Course  Server  until  it  encounters  an  "end- of- file" 
character.  When  the  "end-of-file"  character  is  read,  the  client  then  closes  the  socket 
connection  as  shown  in  Figure  3.8.  See  Appendix  H  for  a  complete  description  of  the 
QuestionApplet. 


try  { 

s  =  new  Socket  (this .getCodeBase ()  .getHost ()  ,  PORT); 

out  =  new  PrintStream (s .getOutputStream ( ) ) ; 

out  .println  (score+"  I  "  +lesson_f  ile)  ,- 
System. out .println ( "Score  I Lesson_f ile=" +score+"  I " +lesson_f ile; 

} 
catch  (IOException  e)  { 

System. out .println ( "No  Socket ->" +e . toSt ring ( ) ) ; 

error ( "Socket  Could  Not  Be  Opened!"); 
•  } 


Figure  3.7  QuestionApplet  creating  socket. 
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try  { 

//***  wait  until  it  gets  a  stream  from  server 

for ( ; ; )  { 

line  =  in. readLine ( ) ;   //**  read  in  string  line  from  server 

if  (line  !=  null)  break; 

num_trys  =  (num_trys  +1); 

//**  build  a  dialog  to  ask.  whether  to  abort  or  continue 

if  (num_trys  >  80)  { 

error ( "Nothing  coming  in  from  server") ; 
} 
}  //**  for 

}  //**  try 

catch  (IOException  e)  { 

error ("Error  Reading  Lesson  From  File!"); 

}  //**  if 

finally  { 

try  { 

if  (s  !=  null)  { 

s.closeO ;  //**  socket  closed  by  Client 
} 

} 

catch (IOException  e2 )  { 

error ( "Socket  Could  Not  Be  Closed!"); 
} 
}  //**  finally 

Figure  3.8  QuestionAppIet  reads  until  no  more  data. 

The  networking  and  AWT  packages  will  be  used  throughout  Chapter  IV  to 
illustrate  the  usefulness  of  Java  in  creating  active  courseware  via  the  Web. 
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IV.  ACTIVE  CONTENT  IN  COURSEWARE 

Using  the  basics  of  HTML  discussed  in  the  Chapter  II,  raw  text  can  be  formatted  in  a 
Web  page  to  look  more  like  a  cleanly  printed  page  than  Courier-based  ASCII  text.  Images 
may  be  added  to  support  material  described  in  the  text.  For  the  most  part,  these  pages  could 
be  printed  from  the  browser  onto  paper  and  used  as  notes  or  any  other  reference  material. 
Many  forms  of  previously- printed  materials,  from  textbooks  to  user  manuals,  have  been 
converted  into  HTML.  The  next  step  is  to  take  advantage  of  active  content  to  allow  the  user 
to  interact  with  the  instructional  material. 

Active  content  within  Web  pages  is  expressed  in  a  programming  language.  In  some 
cases,  this  may  be  a  scripting  language  (JavaScript,  VBScript,  etc.)  and  in  other  cases  a  more 
general  purpose  language  (Java,  ActiveX).  Depending  on  the  kind  of  Web-based  courseware 
being  developed,  one  may  choose  among  these  different  languages.  Some  offer  the  ability  to 
modify  local  files  on  a  client's  machine  while  others  do  not.  If  this  is  not  a  design  issue,  then 
the  choice  may  be  determined  by  the  desired  features  of  a  target  browser.  Both  Netscape  and 
Microsoft  Web  browsers  support  Java  while  ActiveX  is  proprietary  only  to  Microsoft.  The 
security  model  of  the  Netscape  implementation  of  the  Java  interpreter  does  not  allow  full 
access  to  the  client's  operating  system  while  ActiveX  has  full  access. 

To  illustrate  these  concepts,  we  look  at  three  examples  with  increasing  levels  of 
interaction.  Though  these  examples  are  based  on  our  experience  in  teaching  a  programming 
course,  they  could  be  about  most  any  topic  that  has  rules,  illustrations  and  examples  for 
students  to  follow.  The  first  applet  is  an  educational  aid  taken  from  CS2973.  It  helps  to 
explain  the  concept  of  scope  for  public,  private  and  protected  visibility  modifiers  in  the 
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Java  programming  language.  The  second  applet  helps  to  explain  the  use  of  Java  arrays.  It 
creates  frames  external  to  the  browser  and  creates  runtime  objects  based  on  the  user  input. 
Our  final  example  illustrates  truly  active  courseware.  It  involves  an  applet  that  connects  to  a 
dedicated  server  in  order  to  retrieve  questions  for  a  user  and  then  scores  the  results  before 
sending  the  user  the  next  lesson. 

A.         AN  EXAMPLE  OF  ACTIVE  CONTENT  IN  COURSEWARE 

Our  first  example,  which  illustrates  a  limited  form  of  interaction,  is  taken  from  a  section 
of  the  online  notes  for  the  Java  programming  course  CS2973.  It  is  an  applet  that  helps  to 
explain  the  class,  method  and  variable  visibility  modifiers  used  in  the  Java  programming 
language. 

The  topic  of  packages  and  access  protection  can  be  quite  confusing.  An  attempt  to 
convey  the  rules  of  visibility  is  given  via  a  static  web  page  in  Figure  4. 1 .  One  must  refer  to  a 
language  reference  manual  and  then  back  to  the  web  page  in  order  to  understand  the  rules. 
For  example,  to  answer  the  second  question  "can  f  see  i",  depends  on  whether  class  c  is 
declared  public  or  private  (Appendix  F).  We  could  introduce  additional  text  that  explains 
this  or  even  include  a  table  like  that  from  Java  in  a  Nutshell[Nutshell96:  p  179].  But  this  forces 
a  user  to  find  the  rule  of  interest  among  the  many  listed. 

The  embedded  Java  applet,  shown  in  Figures  4.2-4.4,  allows  the  reader  to 
independently  experiment  with  the  various  access  modifiers  and  gain  immediate  feedback  as  to 
how  access  is  affected.  The  allowable  keywords  to  enter  into  the  upper  box  are:  private, 
public,  protected,  private  protected  or  just  left  blank.  Once  a  keyword  is  entered  in  the 
upper  box,  the  answer  to  the  question  "can  f  see  i  ?"  is  revealed  in  the  lower  box.  An 
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erroneous  entry  is  rejected  with  an  error  message,  as  shown  in  Figure  4.5.  In  the  enhanced 
version,  the  reader  has  no  doubt  about  the  access  rules  since  the  results  are  displayed 
immediately  after  the  modifier  is  entered.  The  full  text  of  the  applet  is  listed  in  Appendix  F. 


Netscape  -  {Packages] 


File     Edit     View     jGo     Bookmarks     Options     Directory 
Window     Help 


The  places  from  which  one  wishes  to  "see"  definitions  are 


1.    same  class 


class  C   t 

int  i ; 

int   fC  J    L  return   i;}       //can  f   see  1    ? 


2.    same  package  subclass 


//  in   a  source   Hie 
package  p; 
class  C   [ 

int  i ; 

//  in   another   source   file 

package  p; 

cl  ass  D  extends  C   £ 

int    f C  )    {return    i;} 


//  can    f    see    i    ? 


JV-aJI      Document:  Done 


0'? 


B. 


Figure  4.1  Using  static  content  to  explain  visibility  modifiers. 
ANOTHER  EXAMPLE  OF  ACTIVE  CONTENT 


Within  the  scope  of  CS2973,  another  useful  example  is  the  concept  of  an  array 
definition  and  allocation.  Textually,  one  can  describe  an  array  as  "a  vector  or  object  that  stores 
other  objects  or  values  in  cells,  referred  to  as  elements"  and  then  present  an  illustration 
showing  buckets  to  hold  the  values.  With  the  Java  applet  embedded  in  the  text,  the  reader  may 
additionally  manipulate  the  graphical  representation  of  an  array  by  specifying  the  dimensions 
and  actually  placing  values  in  the  cells.  Furthermore,  the  example  demonstrates  how  elements 
in  the  array  can  be  accessed.  The  values  entered  into  the  cells  of  the  newly  created  elements 
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Netscape  -  {Packages] 


File     Edit     View     Go      Bookmarks     Options     Directory     Window     Help 


2.    same  package  subclass 


//A SOURCE  FILE 
package  p, 


class  C  { 


inti; 


) 


//  IN  ANOTHER  SOURCE  FILE 
package  p; 
class  D  extends  C  { 
intfQ  {return  i;} 
} 


//canf  see  i  ? 


2!M 


saf 


Figure  4.2  Using  active  content  to  explain  visibility  modifiers,  initialized. 


Netscape  s  [Packages] 


File     Edit     View     Go     Bookmarks     Options     Directory    Window     Help 


2.   same  package  subclass 


// ASQURCE  FILE 
packagep; 


private 


class  C  { 


inti; 


} 


if  IN  ANOTHER  SOURCE  FILE 
package  p; 
class  D  extends  C  { 
i ntf'O  {return  i;} 

} 


// canf  see  i  ? 


No 


^.sail 


Q'? 


Figure  4.3  Active  content,  first  keyword  entered. 
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Netscape  -  [Packages] 


File     Edit     View     Go     Bookmarks     Options     Directory     Window     Help 
2.    same  package  subclass 

//A  SOURCE  FILE 
package  p, 


public 


class  C  { 


inti; 


} 

fl  IN  ANOTHER  SOURCE  FILE 
package  p, 
class  D  extends  C  { 
intf( )  {return!;} 
} 


//canf  seei '? 


Ves 


E3f 


Figure  4.4  Active  content,  second  keyword  entered. 


Netscape  -  [Packages] 
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2    same  package  subclass 


//A SOURCE  FILE 
package  p; 


public  protected 


class  C  { 


inti; 


} 


//IN  ANOTHER  SOURCE  FILE 
package  p; 
class  D  extends  C  f 
intf()  {return  i;} 

} 


//canf  seei? 


error 


WM 


S2f 


Figure  4.5  Active  content  with  illegal  keyword  entered. 
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array  by  the  user  are  selected  for  use  in  a  calculation.  The  applet  selects  different  cells  based 
on  the  dimensions  of  the  array  that  the  user  creates. 

Figures  4.6-4.8  show  one  method  of  doing  this  with  popup  windows  that  are  displayed 
outside  the  Netscape  browser  using  Java.  Notice  that  the  first  part  of  the  applet  is  embedded 
in  the  web  page  like  any  other.  As  the  demonstration  progresses,  external  windows  are  created. 
When  the  applet  is  complete,  the  external  windows  disappear  and  the  user  may  start  over. 


Netscape  -  {Arrays! 


File     Edit     View     Go     Bookmarks     Options     DJrectory 
Window     Help 


Arrays  are  data  structures  consisting  of  related  items  of  data  of  the 
same  type.  Once  created,  an  array  is  of  fixed  size  though  its  elements 
may  be  referenced  and  reassigned  new  values.  Enter  values  in  the 
following  applet  to  see  how  an  array  can  be  created  then  enter  values 
into  the  array  so  that  they  may  be  referenced  by  a  calculation. 

Enter  integers  in  boxes  then  press  button  to  build  array. 


Make  Array     I 


Figure  4.6  Array  applet,  initialized. 
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Netscape  -  [Arrays] 


File     Edit     View     fio     Bookmarks     Options     Directory 
Window     Help 

Arrays  are  data  structures  consisting  of  related  items  of  data  of  the 
same  type.  Once  created,  an  array  is  of  fixed  size  though  its  elements 
may  be  referenced  and  reassigned  new  values.  Enter  values:  in  the 
following  applet  to  see  how  an  array  can  be  created  then  enter  values 
into  the  array  so  that  they  may  be  referenced  by  a  calculation. 

Enter  integers  in  boxes  then  press  button  to  build  array 


2 


tyaks  Array 


array  window 


Here  is  your  array. 


E 


E 


Enter  values  for  calculation. 


Go! 


Figure  4.7  Array  applet,  new  array  created,  values  entered. 
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Figure  4.8  Array  applet,  elements  referenced  with  result. 
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C.         SERVER-BASED  ACTIVE  CONTENT  IN  COURSEWARE 

Previous  examples  focused  on  the  use  of  Java  applets  embedded  in  Web  pages  to  help 
explain  various  concepts.  The  next  step  is  to  afford  the  user  some  sort  of  self  assessment. 
Forms  of  online  examination  over  networked  computers  have  existed  for  years.  Computerized 
exams  are  common  in  employment  centers,  computer  certification  testing  centers,  and  some 
public  schools  and  can  be  used  anywhere  a  technical  evaluation  of  knowledge  is  needed. 

One  method  of  accomplishing  an  enhanced  type  of  online  evaluation  over  the  Internet, 
using  a  WWW-based  system,  is  to  introduce  a  dedicated  course  server.  We  construct  a  set  of 
lessons,  as  described  in  Chapter  II.  In  addition  to  lesson  text  and  embedded  applets,  a  set  of 
multiple  choice  questions  is  prepared  to  coincide  with  each  topic  discussed.  An  applet  is 
designed  to  present  the  question  set  to  the  user  and  process  the  responses  in  the  browser.  A 
grade  is  then  determined  and  recorded  before  proceeding  to  the  next  lesson.  In  order  to 
accomplish  this,  the  question  applet  communicates  with  a  dedicated  course  server  via  a  socket 
connection  over  the  Internet.  Upon  receiving  a  connection  request,  the  course  server  sends  a 
data  file  to  the  applet  which  contains  the  test  questions,  the  follow-on  text  URL  and  the  name 
of  the  next  question  file. 

In  our  implementation,  the  Netscape  browser  is  loaded  with  a  page  containing  two 
frames.  The  upper  frame  contains  the  textual  content  of  the  lesson.  The  lower  frame  contains 
the  question  applet  which  displays  a  button  as  shown  in  Figure  4.9.  When  pressed,  the  button 
launches  an  external  window  containing  the  question  set,  as  shown  in  Figure  4. 10.  When  the 
user  has  completed  the  question  set,  the  "Grade"  button  is  pressed  as  shown  in  Figure  4. 1 1 . 
The  questions  are  scored  and  the  result  is  shown  to  the  user  as  in  Figure  4. 12.  When  the  user 
clicks  "Next  Lesson",  the  URL  for  the  next  lesson  is  passed  to  the  browser  and  then  loaded 
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into  the  browser's  upper  frame.  Finally,  a  data  stream,  containing  the  score  and  the  next  data 
filename,  is  sent  to  the  course  server  for  parsing. 


Netscape  -  JThe  QuestionApplet  Demo} 


File     Edit     View     Go     Bookmarks     Options     Directory     Window     Help 


Index 


Networking 

java.net  supports  both  TCP/IP  and  HDP  protocol  families. 

TCP/IP  is  used  for  reliable  stream-based  communication  across  the  Internet  It  specifies 
the  manner  in  which  two  processes  running  on  different  machines  on  the  Internet  find 
each  other,  rendezvous,  and  transfer  data.  It  also  makes  sure  data  are  transferred  in  the 
correct  sequence  and  without  error. 

UDP  (Unreliable  Datagram  Protocol)  is  used  for  unreliable  datagram  communication; 
also  called  "fire-and-forget"  packet  transmission  across  the  network. 

TCP/IP  uses  a  static  addessing  scheme- -every  machine  on  the  Internet  is  assigned  a 
unique,  fixed  IP  address. 


Self  Evaluation 


:t}^$j\      Document:  Done 


m$ 


Figure  4.9  Browser  with  two  frames  loaded. 

The  course  server  can  be  written  in  any  language  that  supports  sockets.  In  our 
implementation,  it  is  written  in  Java  and  runs  as  a  background  daemon  which  spawns  a  new 
thread  for  each  connection  request  from  an  applet.  This  allows  multiple  users  to  connect 
concurrently  up  to  the  limitations  of  the  host  system.  See  Figures  3.4  and  3.5  for  source  code 
snippets.  Additionally,  since  this  implementation  is  written  in  Java,  it  will  work  on  any 
platform  that  supports  the  Java  Virtual  Machine. 
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■==                                     Netscape  -  [The  QuestionApplet  Demo]                                     * 

a 

t-l- 

file     Edit     View     Go     Bookmarks     Options     Directory     Window     Help 

Index 

Networking 

j awa;ret  supports  both  'TCP/IP'  and  UDP  protoc ol families. 

♦' 

= 

Question  Frame  For  Lesson  data.txt 

Question  #1 

9 

* 

What  set  of  protocols  is  supported  by  the  jave.net  class? 

* 

TCP/IP  and  UDP 

♦ 

FTP 

ATM  and  IP 

TCP/IP  and  FTP 

Question  /2 

TCP/IP  and  UDP 

PDUandPDQ 

Which  protocol  uses  a  static  addressing  scheme? 

FTP 

♦ 

G 

luestion  #3 

A  class  "B"  address  space  can  haveapproximately  how  many 
address  spaces? 

♦ 

Figure  4.10  Question  applet  displayed  external  to  browser 

Since  the  server  is  relatively  "dumb",  it  only  responds  to  requests  and  sends  files.  It 
does  not  maintain  any  state  information  about  which  machine  or  user  is  connecting  to  it.  The 
applet  running  on  the  client's  machine  maintains  all  state  information  about  the  user  and 
subsequent  sets  of  data.  Once  the  question  applet  classes  are  initially  loaded  into  the  browser, 
successive  question  sets  load  quickly  since  only  the  score  and  the  data  file  pass  over  the 
network;  the  applet  itself  is  not  reloaded.  In  this  arrangement,  the  majority  of  the  workload 
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takes  place  on  the  client  machine,  which  greatly  improves  course  server  performance  over 
traditional  approaches  using  HTTP/CGI  servers. 

Due  to  current  applet  security  implementations,  the  course  server  must  reside  on  the 
same  machine  as  the  applet  class  tiles.  Thus,  the  HTTP  server  and  course  server  are  co- 
located.  The  data  files  may  reside  anywhere  that  the  course  server  can  retrieve  them.  Once  a 
generic  question  applet  and  course  server  are  in  place,  instructors  are  only  required  to  place 
question  files  and  textual  materials  on  the  server. 


Question  Frame  For  Lesson  data.txt 


Question  t? 


The  Socket  Class  only  uses  TCP/IP  protocol  for  communication. 


False 


Lin. 


Cancel 


Grade 


Copyright  1997,  Naval  Postgraduate  School,  CS  Dept 


+1 


1,1      ,       ,1  II 


Figure  4.11  Completion  of  question  set. 


31 


Netscape-  [The  QuestionApplet  Demoj 
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Next  Lesson 
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Figure  4.12  Resulting  score  of  question  set. 
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V.  FUTURE  WORK 

The  techniques  described  in  Chapter  IV  can  be  enhanced  in  many  ways.  However, 
in  order  to  have  a  fully  usable  Web-based  courseware  system,  more  functionality  is 
needed.  We  have  identified  three  major  areas  of  improvement.  The  first  two  areas 
involve  the  QuestionApplet  and  Course  Server.  Each  should  be  extended  to  handle  user 
login  authentication.  Moreover,  the  Course  Server  should  provide  access  to  external 
databases  for  student  identification  and  course  materials.  The  third  area  involves 
facilitating  the  development  of  courseware.  For  this,  we  propose  a  tool  that  we  call  the 
Courseware  Creation  Interface  (CCI).  Each  of  these  areas  is  treated  in  more  detail  below. 

A.  QUESTION  APPLET  AND  COURSE  SERVER 

The  Question  Applet  needs  to  be  modified  to  request  user  identification  and 
authentication  via  password,  and  to  pass  these  parameters  to  the  Course  Server.  The  user 
identification  is  used  to  identify  the  user  to  the  system.  When  the  user  completes  a  lesson, 
the  score  is  recorded  in  a  file  for  review. 

B.  COURSE  SERVER  USING  DATABASES 

The  Course  Server  should  be  modified  to  uniquely  identify  student  records  in  a 
student  database.  There  is  already  a  Java  API  in  place  to  support  connecting  any  Java 
application  to  an  existing  database  using  standard  database  protocols.  This  functionality 
would  be  used,  in  conjunction  with  the  Question  Applet,  to  validate  the  user  upon  login 
and  record  lesson  scores  for  review.  Additionally,  a  lesson  database  should  be  used  to 
maintain  the  entire  system  of  lessons  and  their  corresponding  evaluation  question  sets. 
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Currently,  the  question  sets  for  each  lesson  are  implemented  as  sequential  ASCII  text  files 
with  the  data  members  separated  by  the  pipe  ( I )  symbol,  as  shown  in  Figure  5.1.  The 
Question  Applet  parses  the  data  file  into  various  standard  data  elements.  The  data 
elements  for  each  lesson,  in  order,  are  the  number  of  questions,  background  color  code, 
foreground  color  code,  follow-on  data  filename,  alternate  follow-on  filename,  next  URL, 
first  question,  number  of  possible  choices,  the  multiple  choices  themselves  and  the  number 
of  the  correct  choice. 


411677721510 ldata.txt I  remedial . txt I 

http : //dubhe . cc .nps .navy .mil/- Java/ course /net .html  I 

What    type   of    thread   exists   to   service   other   threads? 1 4  I  red 

thread  I  server   thread  I  daemon  thread  I  green   thread  I  3  I 

Threads   may    :  I  5  I  yield  I  sleep  I  block  I  pre-empt  I  all    of    the   above  I  5  I 

What    is   required  to  make   a  multiple  deposit   bank  transaction  work 

properly? I  4  I serializers I  parallel  programming Imonitor I  synchronized 

methods  I  4  I 

What    is   happening  when  a   Producer/Consumer   is    running  but   nothing 

is   progressing? I  4  I  deadlock | waiting  I livelock I runlock I  3  I 


Figure  5.1  Question  data  file. 
C.         A  COURSEWARE  CREATION  INTERFACE 

Currently,  many  instructors  fail  to  implement  online  courses  because  of  the 
difficulty  in  designing  and  managing  the  HTML  course  work.  Our  idea  of  an  online 
courseware  application  abstracts  this  process  to  a  level  that  allows  anyone  to  create  and 
maintain  online  courses. 

To  this  end,  we  propose  a  Courseware  Creation  Interface  (CCI).  It  provides  an 
environment  that  allows  instructors  to  create  sophisticated  Web-based  courseware.  The 
interface  should  run  within  a  Java  Enhanced  browser,  such  as  Netscape  or  the  Microsoft 
Internet  Explorer,  and  provide  a  "plug  and  play"  type  of  format  for  the  various  tool 
components.  Given  that  the  courseware  is  developed  in  the  Java  programming  language, 
the  CCI  will  have  many  advantages,  among  them,  platform-independence. 
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The  CCI  should  not  be  designed  as  a  HTML  editor,  but  rather  an  application  used 
for  course  standardization,  organization,  and  enhancement.  The  CCI  assumes  the  user 
will  first  produce  individual  course  slides  in  HTML  and  then  place  them  in  a  course 
package  to  be  exported  to  the  Web  or  possibly  to  a  CDROM.  The  course  package 
consists  of  a  course  title  page,  a  course  index  page,  the  enhanced  course  pages  and  other 
standard  courseware  components  such  as  a  white  board,  group  chat  page,  bulletin  listing, 
etc.  Several  screens  have  been  developed  as  a  prototype  for  reference  here,  however  the 
"backend"  has  not  been  written. 

The  main  screen  for  the  CCI  will  require  the  user  to  click  either  the  "First  Time" 
user  button  or  the  "Previous"  button  (Figure  5.2).  By  clicking  the  "First  Time"  button, 
the 
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Welcome  to  The  MPS  Courseware  Development  System 

if  your  are  afirsttime  user,  please  click  FirstTime.    ; 
Else  if  you  haive  already  registered,  then  just  click  Previous. 


First  Time 


'revious 

rrjwwiyrmtWiwn'ri* 


Wm 


Figure  5.2  NPS  Courseware  Initial  Screen  in  Web  Page 
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application  displays  a  registration  page  requiring  the  user  to  input  his  or  her  name,  user 
identification,  and  a  requested  password  (Figure  5.3). 

Once  the  initial  user  registration  screen  is  completed,  the  user  clicks  on  the 
"Cancel"  or  "Register"  button.  A  click  of  the  "Register"  button  displays  the  "Login" 
frame  (Figure  5.4). 


Netscape  -  [NPS  Courseware  Registration] 
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Password: 
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Figure  5.3  Initial  User  Registration  Screen 

The  "Login"  screen  requires  the  user  to  enter  his  or  her  user  ID  and  password.  If 
the  user  ID  or  password  is  incorrect  an  error  frame  is  displayed.  Once  the  correct  user  ID 
and  password  are  entered  and  verified,  the  application  displays  the  course  selection  frame 
(Figure  5.5).  After  the  user  selects  the  course  to  edit  or  create,  the  development  frame  is 
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displayed.  This  frame  allows  the  user  to  customize  the  online  course  by  providing  course 
components  for  the  targeted  course  (Figure  5.6). 


Login  Screen 
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NPS  Course  Development  Login  Screen 


User  ID: 


Password: 


:  login :':'  ]..■ 


Cancel 


Figure  5.4  Courseware  Login  Screen 


Course  Selection  Frame 


Course  Selection  Frame 


Select  or  Enter  The  Course  to  Edit  or  Create 


Figure  5.5  Create  New  or  Edit  Existing  Course  Frame 

For  instance,  if  the  user  desires  to  have  a  whiteboard  with  the  course,  the  user 
simply  marks  the  component  with  an  "X"  in  the  course  development  frame  (see  Figure 
5.6).  The  courseware  slide  organizer  tool  (Figure  5.7)  allows  the  user  to  select  the  slides 
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Figure  5.6  Course  Development  Frame 
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Figure  5.7  Course  Slide  Organizer  Frame 
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(Web  pages)  that  makeup  the  course  by  marking  the  name  of  the  HTML  files  to  include. 
Additionally,  the  user  can  modify  the  presentation  order  of  the  course  slides  by 
highlighting  the  desired  slide  to  move,  and  then  "dragging-and-dropping"  it  into  the  new 
slide  ordering.  The  following  provides  a  more  comprehensive  definition  of  the  tools 
available  in  the  CO,  as  shown  in  Figure  5.6. 

1.  Navigation  Tool 

The  navigation  tool  is  used  to  provide  the  instructor  with  the  ability  to  add 
pre-defined,  standardized  navigational  bars  and  buttons  to  the  course  Web 
pages.  The  navigational  tools  provide  hypertext  links  to  the  previous  page, 
next  page,  and  course  index. 

2.  Glossary  Tool 

The  glossary  tool  allows  the  instructor  to  create  a  searchable  glossary  of 
terms.  Links  from  the  notes  to  the  glossary  entries  are  added 
automatically. 

3.  Course  Bulletin  Board 

The  course  bulletin  board  tool  allows  the  instructor  to  add  a  bulletin-board 
to  the  course.  The  bulletin-board  allows  announcements  to  be  posted, 
including  frequently  asked  questions  and  responses.  This  is  useful  in  any 
course,  but  is  especially  useful  when  course  participants  are  remotely 
located. 

4.  Chat  Tool 

The  chat  tool  allows  the  instructor  to  implement  real-time  communication 
among  course  participants.  This  could  be  used  for  instructor  "office  hours" 
or  student  communication. 

5.  Counter  Tool 

The  counter  tool  allows  the  instructor  add  a  page-reference  counter  to  any 
page  of  notes  and  provides  some  feedback  about  the  amount  of  usage  a 
page  receives.  The  counter  tool  has  user  configurable  font  size, 
foreground  color,  background  color,  and  initial  count  value. 

6.  Evaluation  Builder  Tool 

As  mentioned  in  Sections  A  and  B,  the  lesson  evaluation  tool  allows  the 
instructor  to  create  lesson  evaluations  for  each  lesson.  The  lesson 
evaluation  tool  allows  the  instructor  to  implement  lesson  questions  and 
solutions  sets  (Figure  5.7).  The  lesson  questions  can  supplement  any  page 
of  notes.  If  there  are  any  questions  associated  with  a  page,  the  courseware 
generates  a  button  on  the  bottom  of  the  page.  Clicking  that  button 
presents  the  questions  in  a  scrollable  frame  as  described  in  Chapter  IV. 
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The  course  author  creates  questions,  potential  answers  and  an  explanation 
for  each  answer  on  the  Question  Creation  Frame.  Aside  from  the 
questions,  answers  and  explanations,  the  author  must  indicate  which  is  the 
correct  answer  for  each  question,  and  with  which  page  this  set  of  questions 
is  associated. 

7.  White  Board 

The  white  board  tool  allows  the  instructor  to  create  a  white  board  for  the 
course.  The  white  board  is  a  collaborative  tool  allowing  groups  of  students 
to  create  and  edit  documents,  in  parallel,  over  the  WWW.  Additionally, 
text  and  drawing  can  be  created  and  supported  for  later  re-editing,  display, 
or  printing. 

8.  Password  Tool 

The  password  tool  allows  the  instructor  to  create  a  userid  and  password 
for  the  course  or  designated  pages. 

9.  Help  Tool 

The  help  tool  allows  the  user  to  create  a  course-specific  help  index.  The 
help  index  is  active  throughout  the  course  and  is  accessed  by  clicking  the 
right  mouse  button. 

10.  Slide  Organizer  Tool 

The  slide  organizer  tool  provides  the  instructor  with  the  ability  to  organize 
the  slides  in  a  top-down,  hierarchical  manner.  An  instructor  can  select  the 
desired  files  to  be  included  in  the  final  course  build  routine  and  re-position 
them  in  the  hierarchical  structure  if  needed(Figure  5.7). 
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Figure  5.8  Course  Evaluation  Creation  Frame 

Obviously,  the  CCI  is  not  a  HTML  editor,  however  it  does  provide  limited 
functionality  in  enhancing  individual  course  pages.  We  propose  the  following  page 
courseware  tools  to  insert  the  appropriate  HTML  code  into  CCI  files: 

1.  Electronic  Mail 

A  electronic  mail  tool  allows  the  instructor  to  insert  clickable  email  tags 
into  the  HTML  page.  These  clickable  email  tags  can  be  defined  to  send 
mail  to  the  instructor,  individual  students  or  to  other  predefined  email 
addresses. 

2.  Searchable  Image  Database 

The  searchable  Image  Database  tool  provides  a  user  implemented  database 
of  images  that  can  be  linked  to  course  pages.  This  allows  the  association 
of  names  and  keywords  with  each  image.  Therefore,  users  can  search  for 
images  based  on  the  name  or  keywords. 

3.  Uniform  Resource  Locator  (URL)  Tool 

The  URL  tool  provides  the  ability  to  place  a  button-bar  icon  on  any  Web 
page  linked  to  an  arbitrary  URL.  This  allows  arbiuary  links  to  audio, 
images,  or  other  documents. 
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Once  a  user  has  completed  editing  and  has  clicked  the  "Course  Builder"  button, 
the  course  completion  frame  is  displayed  (Figure  5.6).  The  course  completion  frame 
signals  that  the  course  was  created  successfully  with  the  additions  of  the  course  title  page, 
course  index  page,  course  selected  enhanced  pages  and  courseware  component  pages 
(Figure  5.9). 


Course  Completion  Frame 


»:-  .:*: 


Course  CS2973  Created  Successfully 


Continue 


Figure  5.9  Course  Creation  Completion  Frame 
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VI.  RELATED  WORK  AND  CONCLUSIONS 

During  our  studies,  we  became  aware  of  other  Web-based  educational  courseware 
implementations.  In  order  to  better  understand  these  related  works,  we  classified  them 
into  four  distinct  categories: 

1.  Administrative  Support  -  web  sites  that  merely  display  an  instructor's 
administrative  material  such  as  class  dates,  text  to  read,  grading  scope,  etc.  for 
a  regularly  scheduled  college-level  course. 

2.  Distance  Learning  Support  -  course  materials  that  supplement  video-based 
distance  learning  with  Web-based  course  notes. 

3.  Tutorial  -  a  self-paced  set  of  Web-based  notes  that  allows  a  user  to 
independently  review  and  learn  from  the  material  at  any  time. 

4.  Online  Course  -  a  web-based  course  that  allows  the  user  to  access  the  notes  of 
a  course  and  has  an  active  facilitator,  usually  offered  through  a  university. 

The  online  course  is  similar  to  a  tutorial  with  one  major  exception.  In  a  tutorial, 

there  is  no  interaction  between  student  and  instructor.  In  contrast,  the  online  course  has 

an  instructor  that  facilitates  the  course  and  provides  guidance  to  the  students  when 

needed.  The  following  is  a  list  of  other  Web- based  courseware  efforts  classified  according 

to  the  categories  above. 

1.  New  Jersey  Institute  of  Technology   http://www.njit.edu/  (Dist.  Learning) 

2.  The  Java  Tutorial    http://pelu.jns.fi/~treijo/javatutor/index.html(Tutorial) 

3.  University  of  California  at  Berkeley's  Chemistry  course 
http://www.cchem.berkeley.edu/~cheml30a/  (Admin) 

.  4.    The  Globewide  Network  Academy  (GNA) 

http://uu-gna.mit.edu:8001/uu-gna/index.html  (Admin) 

5.  Dakota  State  University  -  Internet  Courses 
http://www.dsu.edu/distance-ed/internet.html  (Admin) 

6.  University  of  Illinois  at  Urbana,  Classes  on  the  Web 
http://www.uiuc.edu/webclasses.html  (Online) 

7.  University  of  Massachusetts,  Dartmouth,  CyberEd 
http://www.umassd.edu/cybered/courses.html  (Online) 

8.  University  of  Phoenix  Home  Page  http://www.uophx.edu/online/  (Online) 

9.  University  of  Washington  in  Seattle 
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http://www-hpcc.astro.washington.edu/scied/chemistry.html  (Admin) 

10.  The  Heritage  Institute  of  Seattle,  Washington  On-line 
http://www.hol.edu/     (Admin) 

11.  The  Naval  Postgraduate  School,  "Introduction  To  Object  Oriented 
Programming",  http://vislab-www.nps.navy.mil/~java  (Hybrid) 

Although  the  list  we  have  developed  is  short,  given  the  speed  of  Web 
development,  we  anticipate  that  this  list  will  continue  to  grow  rapidly. 

A  key  feature  of  putting  all  lecture  materials  in  HTML  is  real  portability.  By 
using  relative  URLs  within  the  course  material,  all  pages  are  initially  linked  to  from  an 
index  page.  The  entire  set  of  pages  may  be  copied  to  a  hard  drive  and  accessed  on  a 
stand-alone  computer,  without  a  HTTP  server  or  a  network  and  without  modifying  the 
code.  Furthermore,  this  same  technique  could  be  used  to  put  entire  academic  or 
commercial-grade  courseware  on  CDROM. 

Although  we  make  several  references  to  CS2973  in  this  thesis,  the  course  was 
taught  in  the  classroom,  not  as  courseware.  The  Web  was  used  as  a  communication 
mechanism  between  the  instructor  and  students,  as  a  medium  for  visual  presentation  of  the 
lecture  notes  in  the  classroom  and  as  a  source  of  supplemental  information  for  the  course 
material.  With  the  aid  of  an  overhead  projector  connected  to  a  networked  computer 
display,  HTML  documents  were  viewed  by  students  in  the  classroom  through  a  Web 
browser.  Appendix  C  describes  the  resources  used  in  this  course.  The  HTML  files 
remained  on  the  Web  server  for  easy  access,  future  reference,  and  review  by  not  only  the 
enrolled  students,  but  by  anyone  from  anywhere  in  the  world.  CS2973  could  be 
developed  into  an  online  course  without  much  additional  effort.  The  notes,  assignments 
and  communication  mechanisms  are  already  in  place. 
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Departments  such  as  Computer  Science  have  no  trouble  taking  full  advantage  of 
the  power  of  the  Web  for  course  content  delivery.  In  contrast,  other  departments  less 
technologically  focused,  such  as  National  Security  Affairs,  are  either  not  taking  advantage 
of  the  Web  or  are  not  exploiting  its  full  power.  The  main  difficulty  is  the  initial  burden 
placed  upon  insu"uctors  to  completely  re-think  the  nature  of  their  course  and  to  adapt  their 
teaching.  The  envisioned  Java  courseware  application  will  offer  a  tool  for  educators  that 
provides  course  standardization,  organization,  online  access,  portability  and  ease  of  use. 
By  implementing  Java  courseware  that  abstracts  the  complicated  details  of  HTML,  Java 
applets,  and  Java  CGIs,  instructors  at  all  levels  can  take  full  advantage  of  the  World  Wide 
Web's  potential. 

Whether  or  not  you  agree  with  the  philosophy  of  online  education,  the  face  of 
higher  education  is  changing.  Will  our  vision  of  the  future  come  to  pass?  One  thing  is 
certain.  The  information  superhighway  is  going  to  have  a  significant  impact  on  the  way 
universities  and  organizations  educate  people.  In  many  ways,  education  through  media, 
like  the  Web,  enable  more  people  to  have  access  to  knowledge  than  ever  before.  In  this 
age  of  information,  this  is  not  only  a  luxury —  it  is  a  necessity. 
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APPENDIX  A  -  COURSE  NOTES 

The  following  pages  represent  the  CS2973  Course,  "An  Introduction  To  Object 
Oriented  Programming  Using  Java".  These  notes  were  developed  jointiy  by  the  authors 
and  Professor  Dennis  Volpano.  This  notes  were  created  in  HTML  format  and  are  located 
at  the  web  page  address  of  http://vislab-www.nps.navy.mil/~java. 
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Introduction  to  Object-Oriented  Programming 
with  Java  (CS2973) 

Summer  1996 

Instructor 

Dennis  Volpano,  SP532A 
email:volpano@cs.nps.navy.mil 

Teaching  Assistants 

Wes  Hester  and  Richard  Moormann 

Textbooks 

The  Java  Handbook  by  Patrick  Naughton,  McGraw  Hill,  and 

Java  in  a  Nutshell  by  David  Flanagan,  O'Reilly  and  Associates  Inc.  (errata) 

We  will  also  be  using  in  the  classroom  MindQ's  CD  titled  "An  Introduction  to  Programming  Java 
Applets". 

Prerequisites 

Every  student  is  required  to  have  an  NPS  computer  account.  If  you  do  not  have  one  then  get  one  from 
the  Church  Computing  Center  in  Ingersoll  Hall.  You  should  have  a  basic  understanding  of  various 
UNIX  commands  needed  to  manipulate  files  and  directories.  It  would  also  help  if  you  were  "somewhat" 
familiar  with  Web  browsers  and  ubiquitous  terms  like  URL  and  HTTP.  Consider  yourself  at  an 
advantage  if  you  know  how  to  execute  the  Netscape  Navigator  Web  browser.  Java-deficient  browsers 
like  X-Mosaic  don't  qualify  here.  As  a  simple  exercise,  if  you're  viewing  this  with  Netscape,  click  here 
to  visit  the  CS  Java  home  page,  return  to  this  page,  and  then  view  the  HTML  source  for  this  document  to 
see  the  Java  home  page  URL.  What  is  it? 

Exercises  and  Final  Project 

Look  Mom.  No  Exams! 

There  will  be  four  graded  homework  exercises.  They  will  constitute  60%  of  your  final  grade.  The 
remaining  40%  of  your  grade  will  be  determined  by  a  final  project. 
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CS2973  Syllabus 

1.  An  Overview  of  Java 

O  History  of  the  Language 

O  The  Java  Programming  Paradigm 

2.  The  Java  Applet 

O  Hello  World 

O  The  Java  Developer's  Kit  (JDK) 

O  The  APPLET  tag  and  Java-related  HTML  Syntax 

O  The  AppletViewer 

O  The  Scribble  Applet  (Example  1-2  of  Java  in  a  Nutshell) 

O  A  Simple  Text  Editor 

3.  The  Basics  of  Object-Oriented  Programming 

O  What  is  inheritance? 

O  What  are  classes  and  objects? 

4.  Java  Basics  (Chapters  3-6,  9  and  10  of  The  Java  Handbook) 

O  Main  Method  (Chapter  3) 

O  Lexical  Issues  (Chapter  3) 

O  Types 

O  Simple  Types  and  Arrays  (Chapter  4) 

O  Strings  (Chapter  9) 

O  Operators  (Chapter  5) 

O  Flow  Control  (Chapter  6) 


O  Exceptions  (Chapter  10) 

5.  Java  Classes,  Packages  and  Objects  (Chapters  7  and  8) 

O  Classes 
O  Interfaces 
O  Packages 

6.  Input/Output  (Chapter  13) 

O  File  and  FileFilter 
O  Streams  Overview 
O  File  I/O 

7.  Applets  (Chapter  15) 

O  Applets  or  Applications 

O  Handling  Applet  Events  (pp.  88-92  of  Nutshell) 

8.  GUI  and  the  AWT  (Section  5  of  Nutshell) 
A  recommended  AWT  article. 

O  Components  and  Containers 

O  Subcomponents 

O  Panels  and  Layouts 

9.  Java  Networking 

O  Sockets 

10.  Java  Threads 

O  Synchronization  and  communication 

1 1 .  Java  Security 

O  The  Java  security  model 
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Object-Oriented  Fundamentals 


•  Encapsulation 

•  Classes  and  Objects 

•  Inheritance 

The  components  above  are  widely  believed  to  capture  the  essence  of  object-oriented 
(00)  programming  languages. 

We  look  at  each  in  turn. 

Encapsulation 

The  idea  of  hiding  representations  of  data  from  clients  is  called  encapsulation. 

Consider  the  following  example. 

We  need  a  graphics  library  for  handling  polygons,  rectangles,  circles,  etc. 

First  we  introduce  polygons: 

type  polygons    is    some    type  representing  a   list   of  vertices; 

procedure    translate    (p    :    polygons;    a,    b    :    real)    is 
//    translate   every  vertex   in  p  by  adjusting 
//    it   horizontally  by  a   and  vertically  by  b 

end; 

function  perimeter  (p  :  polygons)  :  real  is 

//  sum  lengths  between  vertices  of  p 
end; 

Now  we  use  these  definitions  as  in 

p  :  polygons; 
x,  y,  r  :  real; 

...  translate (p,  x,  y)  ; 

...  r  :=  perimeter (p) ; 


Here  p  can  be  modified  directly. 

So  the  program  may  be  sensitive  to  the  representation  of  polygons. 

We  need  to  encapsulate  the  representation.  In  Ada,  this  is  done  as  follows: 

package  polygon_package  is 

type  polygon  is  private 

procedure  translate  (...); 

function  perimeter (... )  returns  real; 

private 

type  polygon  is  some    type; 
end  polygon_package; 

package  body  polygon_package  is 

end  polygon_package; 

Classes  and  Objects 

00  languages  support  encapsulation  through  classes. 

A  class  is  like  a  package  specification  in  Ada  with  one  key  difference. 

Classes  effectively  serve  as  the  types  of  records  (tuples)  which  are  values  in  the  language. 

To  use  an  Ada  package,  one  writes 

WITH  polygon_package; 
USE  polygon_package; 

p  :  polygon; 

...  translate (p,  x,  y) ; 

...  r  :=  perimeter (p) ; 

In  an  00  language,  the  members  of  a  package  become  the  fields  of  a  record: 

type  polygons  is  record 

v  :  some    type        //   vertices  field 
procedure  translate  (a,  b  :  real)  is 

//  code  to  adjust  vertices  in  v 
end; 
function  perimeter  ()  :  real  is 


//  sum  lengths  between  vertices  in  v 
end; 
end  record; 

Notice  that  translate  and  perimeter  no  longer  take  a  polygon  as  a  parameter: 

p  :  polygons; 

...  p. translate (x,  y) ; 

...  r  :=  p. perimeter () ; 

We  must  hide  the  definition  of  v  from  users  of  polygons  so  that  one  cannot  write  p .  v. 

For  this,  00  languages  furnish  quantifiers  such  as  private  and  public: 

type  polygons  is  record 

private  v  :  some   type 

public  procedure  translate  (a,  b  :  real)  is 

//  code  to  adjust  vertices  in  v 
end; 
public  function  perimeter  ( )  :  real  is 

//  sum  lengths  between  vertices  in  v 
end; 
end  record; 

In  00  languages,  record  types  are  classes. 

So  polygons  is  a  class: 

class  polygons  is 

private  v  :  some    type 

public  procedure  translate  (a,  b  :  real)  is 

//  code  to  adjust  vertices  in  v 
end; 
public  function  perimeter  ()  :  real  is 

//  sum  lengths  between  vertices  in  v 
end; 
end  class;' 

So  it  is  not  surprising  that  Java  has  no  record  types. 

A  record  of  type  (class)  polygons  is  called  an  instance  or  object  of  the  class  polygons. 

Objects  are  "manipulated"  at  runtime,  not  classes. 

What  is  the  major  advantage  of  encapsulating  data  via  classes? 


•  Code  reuse  and  flexibility 
Suppose  we  have  a  specific  polygon  called  rectangle: 

class  rectangle  is 

private  v  :  some   type   II    4  vertices 
private  sidel,  side2  :  real; 
public  procedure  create  ( )  is 

//  create  rectangle 
end; 
public  procedure  translate  (a,  b  :  real)  is 

/ /  as  above 
end; 
public  function  perimeter  ( )  :  real  is 

return  2  *  (sidel  +  side2) ; 
end; 
end  class; 

Now  we  would  like  to  be  able  to  write  something  like 

p  :  polygons; 

if  chosen_icon  =  rectangle_icon  then 

r  :  rectangle; 

p    :=   r. create;  //    a   rectangle    is    a  polygon 

elseif   chosen_icon  =   circle_icon  then 

c    :    circle;  //    a  circle   is   a  polygon 

p    :=    c. create; 
elseif    . . . 

p. translate (x,    y) ;     ...    z    :=   p. perimeter () ; 

Here  the  name  perimeter  behaves  as  though  it  is  polymorphic. 

It  seems  to  denote  a  method  that  operates  on  many  different  forms  of  polygons. 

In  reality,  each  kind  of  polygon  is  bundled  with  its  own  perimeter  method  that  gets 
invoked.  Which  one  is  invoked  by  p .  perimeter  ( )  is  not  known  until  runtime. 

Consider  an  alternative  formulation  in  a  language  without  objects. 

One  has  to  define  polygons  as  say  a  variant  record. 

The  procedure  perimeter  then  becomes 

procedure  perimeter    (p    :    polygons)    is 


case  p. polygon type  of 

rectangle  :  ... 
circle  :  ... 
end; 

The  procedure  is  fragile;  adding  new  polygontype  requires  it  to  be  changed. 

Inheritance 

Intuitively,  we  regard  a  rectangle  as  a  polygon. 

00  programming  languages  allow  us  to  represent  this  intuition  through  inheritance. 

Inheritance  is  usually  specified  by  some  sort  of  class  extension. 

In  C++,  it  is  a  derived  class  and  in  Java  it  is  an  extended  class. 

Reconsider  rectangle: 

class  rectangle  extends  polygons 

private  sidel,  side2  :  real; 
public  procedure  create  ( )  is 

//as  before 
end; 
public  function  perimeter  ( )  :  real  is 

return  2  *  (sidel  +  side2); 
end; 
end  class; 

Now  rectangle  inherits  translate  from  polygons  and  overrides  (shadows) 

perimeter  of  polygons. 
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Main  Method 

Sample  class  with  main  ( )  method: 

import  java.util .Date; 
class  DateApp  { 

public  static  void  main(String  args[])  { 
Date  today  =  new  Date ( ) ; 
System. out .print In (today) ; 
} 
} 

A  Java  application  must  contain  a  main  ( )  method  whose  signature  looks  like  this 

public  static  void  main (String  args [ ] ) 

The  method  signature  for  the  main  ( )  method  contains  three  modifiers: 

•  public  indicates  that  the  main  ( )  method  can  be  called  by  any  object. 

•  static  indicates  that  the  main  ( )  method  is  a  static  method  (also  known  as  class  method). 

•  void  indicates  that  the  main  ( )  method  has  no  return  value. 

The  main  ( )  method  in  the  Java  language  is  similar  to  the  main  ( )  function  in  C  and  C++.  When  you 
execute  a  C  or  C++  program,  the  runtime  system  starts  your  program  by  calling  its  main  ( )  function  first. 
The  main  ( )  function  then  calls  all  the  other  functions  required  to  run  your  program. 

Similarly,  in  the  Java  language,  when  you  execute  a  class  with  the  Java  interpreter,  the  runtime  system 
starts  by  calling  the  class's  main  ( )  method.  The  main  ( )  method  then  calls  all  the  other  methods 
required  to  run  your  application. 

If  you  try  to  run  a  class  with  the  Java  interpreter  that  does  not  have  a  main  ( )  method,  the  interpreter 
prints  an  error  message. 

Arguments  used  by  the  mainO  Method 

The  main  ( )  method  accepts  a  single  argument  which  is  an  array  of  Strings. 

public    static  void  main (String  args[]) 

This  array  of  Strings  is  the  mechanism  through  which  the  runtime  system  passes  information  to  your 
application.  Each  String  in  the  array  is  called  a  command  line  argument.  Command  line  arguments  let 
users  affect  the  operation  of  the  application  without  recompiling  it.  For  example,  a  sorting  program 
might  allow  the  user  to  specify  that  the  data  be  sorted  in  descending  order  with  this  command  line 
argument: 


-descending 

Note  for  C  and  C++  Programmers:  The  number  and  type  of  arguments  passed  to  the  main  ( )  method 
in  the  Java  runtime  environment  differ  from  the  number  and  type  of  arguments  passed  to  C  and  C++'s 

main( )  function. 
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Strings  &  StringBuffers 


What  is  a  String  or  StringBuffer? 

Think  of  a  String  or  StringBuffer  as  a  data  structure  that  stores  character  data  only!  However  the 
String  and  StringBuffer  have  some  differences. 

Java  uses  two  classes  that  store  and  manipulate  character  data. 

1.  String  :  used  for  constant  strings;  can't  be  modified! 

2.  StringBuffer:  used  for  mutable  strings;  ones  that  can  be  modified  (reversed,  appended  too, 
reduced  etc.). 

Let's  look  further  at  each: 

1.  String 

2.  SringBuffer 

3.  Accessor  Methods 

The  difference  is  that  Strings  are  not  mutable  wereas  StringBuffers  are  mutable! 


ff 


String" 


Derived  from  the  Class  java.lang.String. 

As  stated  before,  the  String  stores  a  constant  String  value.  This  means  that  once  you  make  an 
assignment  to  the  String  constant  the  value  can  not  be  modified  after  creation: 

String  Name:  //  creates  a  variable  of  type  String,  Name 


The  Java  compiler  insures  that  each  String  constant  actually  is  a  String  Object.  Since  String 
Objects  are  immutable  they  can  be  shared: 

String  Name  =  "Wes"; 

creates  a  variable  of  type  String  named  Name  with  an  assigned  value  of  Wes  which  is  equivalent 
to: 

char  data  []    =    {'VI',     'e',     's'}; 
String   temp   =   new  String (data) ; 


"StringBuffer" 

Derived  from  the  Class  java.lang.StringBuffer. 


StringBuffers  are  "mutable"  -  they  can  be  changed,  modified,  etc!  The  StringBuffer  is  a  growable 
buffer  for  characters.  It  is  mainly  used  to  create  Strings.  The  Java  compiler  uses  it  to  implement  the  "+" 
operator. 

For  example: 

"W"+4  +  "s"; 

is  compiled  to: 

new  StringBuffer().append("W").append(4).append("c").toString() 

Note  that  the  method  toStringO  does  not  create  a  copy  of  the  internal  buffer.  Instead  the  buffer  is  marked 
as  shared.  Any  further  changes  to  the  buffer  will  cause  a  copy  to  be  made. 

Declaring  StringBuffers 

int  len  =  5 ; 

StingBuffer  name  =  new  StringBuf f er (length_to_make_StringBuf fer) ; 

Now  we  have  just  created  an  object  called  name  of  type  StringBuffer.  Additionally, 
StringBuffer  objects  can  be  created  with  the  java.lang.StringBuffer  Constructors. 

Sample  "StringBuffer"  file 
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"Accessor  Methods" 


Accessor  Methods  are  the  methods  used  to  obtain  information  about  an  object.  For 
example: 

public  static  String  traverselt (String  source) 

{ 

int  i,  len  =  source . length () ; 
StringBuffer  dest  =  new  StringBuf fer (len) ; 
for  (i  =  0;  i  <  len;  i++) 
{ 

dest . append ( source . charAt ( i ) ) ; 

} 

return  dest . toString ( ) ; 

} 

Above  there  are  two  Accessor  Methods : 

1.  int  len  =  source. length () ; 

2 .  dest . append ( source . charAt ( i ) ) ; 

An  object's  instance  variables  are  encapsulated  within  the  object,  hidden 
inside,  safe  from  inspection  or  manipulation  by  other  objects.  With  certain 
well-defined  exceptions,  the  object's  methods  are  the  only  means  by  which  other 
objects  can  inspect  or  alter  an  object's  instance  variables.  Encapsulation  of 
an  object's  data  protects  the  object  from  corruption  by  other  objects  and 
conceals  an  object's  implementation  details  from  outsiders.  This  encapsulation 
of  data  behind  an  object's  methods  is  one  of  the  cornerstones  of 
object-oriented  programming. 

Sample  "Accessor  Method"  file 
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Operators 


In  the  world  of  automation  there  are  three  (3)  types  of  operation  notations: 

1.  Infix 

2.  Prefix 

3.  Postfix 

However,  Java  uses  infix  notation  to  perform  a  given  operation  on  two  operands.  Example:  Java 
Operators  are  classified  into  four  (4)  categories: 

1.  Arithmetic  Operators:  [  *,+,-/,%,A]  The  Java  language  supports  various  arithmetic 
operations—including  addition,  subtraction,  multiplication,  and  division—on  all  numbers.  The  statement 
count-H-  uses  a  short  cut  operator  ++,  which  increments  a  number. 

2.  Relational  Operators:  [  ==,  !=,  <,  >,  <=,  >=]  The  relational  operators  compare  two  values  and 
determine  the  relationship  between  them.  For  example,  !=  returns  true  if  two  values  are  unequal.  The 
character-counting  program  uses  !=  to  determine  whether  the  value  returned  by  System.in.read()  is  not 
equal  to  - 1 . 

3.  Logical  Operators:  [  &&,  II]  The  logical  operators  take  two  values  and  perform  boolean  logic 
operations.  Two  such  operators  are  &&  and  II,  which  perform  boolean  and  and  boolean  or  operations, 
respectively.  Typically,  programmers  use  logical  operators  to  evaluate  compound  expressions.  For 
example,  this  code  snippet  verifies  that  an  array  index  is  between  two  boundaries: 

if  (0  <  index  &&  index  <  NUM_ENTRIES) 

4.  String  Operators:  [  +  ]  The  Java  language  extends  the  definition  of  the  operator  +  to  include  string 
concatenation.  The  example  program  uses  +  to  contenate  "Input  has  ",  the  value  of  count,  and  "  chars." 

System.out.println( "Input  has  "  +  count  +  "  chars."); 

Operator  Precedence:  The  Java  language  allows  you  to  create  compound  expressions  and  statements 
such  as  this  one: 

x  *  y  *  z 

In  this  particular  example,  the  order  in  which  the  expression  is  evaluated  is  unimportant  because 
multiplication  is  commutative.  However,  this  is  not  true  of  all  expressions,  for  example: 

x*y/100 


gives  different  results  if  you  perform  the  multiplication  first  or  the  division  first.  You  can  use  balanced 
parentheses  (  and  )  to  explicitly  tell  the  Java  compiler  the  order  in  which  to  evaluate  an  expression,  for 
example  x  *  (y  /  100),  or  you  can  rely  on  the  precedence  the  Java  language  assigns  to  each  operator. 
This  chart  illustrates  the  relative  precedence  for  all  Java  operators. 


Precedence  Chart 


(in  decreasing  order  of  precedence) 


Precedence 

Operator 

Description 

Type 

Associativity 

++ 

Pre-or-post 
increment 

Arithmetic 

Right  to  Left 

— 

Pre-or-post 
decrement 

Arithmetic 

Right  to  Left 

+,- 

unary  plus, 
minus 

Arithmetic 

Right  to  Left 

~ 

Bitwise 

Complement 

(unary) 

Integral 

Right  to  Left 

! 

Logical 
Complement 

(unary) 

Boolean 

Right  to  Left 

(type) 

Cast  to  a  type 

Any  Type 

Right  to  Left 

2 

*,  /,  % 

Multiplication, 

Division, 

Remainder 

(Mod) 

Arithmetic 

Left  to  Right 

3 

+,- 

Addition, 
Subtraction 

Arithmetic 

Left  to  Right 

3 

+ 

String 
Concatenation 

String 

Left  to  Right 

4 

« 

Left  Shift 

Integral 

Left  to  Right 

4 

» 

Right  Shift  with 
sign  extension 

Integral 

Left  to  Right 

4 

>» 

Right  Shift  with 
zero  extension 

Integral 

Left  to  Right 

5 

<,<= 

Less  than,  Less 
than  equal 

Arithmetic 

Left  to  Right 

5 

>,>= 

Greater  than, 
Greater  than 
equal 

Arithmetic 

Left  to  Right 

5 

instanceof 

Type  of 
comparison 

Object  Type 

Left  to  Right 

6 

= 

Equal  to 

Primitive 

Left  to  Right 

6 

== 

Equal  to 

Object 

Left  to  Right 

6 

i= 

Not  equal  to 

Object 

Left  to  Right 

7 

& 

Bitwise  AND 

Integral 

Left  to  Right 

7 

& 

Boolean  AND 

Boolean 

Left  to  Right 

8 

A 

Bitwise  XOR 

Integral 

Left  to  Right 

8 

A 

Boolean  XOR 

Boolean 

Left  to  Right 

9 

1 

Bitwise  OR 

Integral 

Left  to  Right 

9 

1 

Boolean  OR 

Boolean 

Left  to  Right 

10 

&& 

Conditional 
AND 

Boolean 

Left  to  Right 

11 

II 

Conditional  OR 

Boolean 

Left  to  Right 

12 

?: 

Conditional 

(ternary) 

operator 

Boolean,  any 

Right  to  Left 

13 

=  *=  /=  %= 

+=,  -=,  «=, 
»=,  >»=, 

&=,  *=,  1= 

Assignment  with 
operation 

Variable,  any 

Right  ot  Left 
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Infix  Notation 

Infix  notation  is  operator  +  operator 
ie.  10  =  5  +  5 


Top 


Prefix  Notation 

Prefix  notation  is  +operator  operator 
ie.  10  = +  5  5 


Top 


Postfix  Notation 

Postfix  notation  is  operator  operator  + 

ie.  10  =  5  5  + 


Top 
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Exceptions 

I.  What  is  an  Exception? 

(Java  Handbook,  Chap  10,  pg  165) 

An  event  that  occurs  during  the  execution  of  the  program  that  prevents  the  continuation  of  the  normal 
flow  of  instructions,  such  as  the  divide  by  0  (ie  4/0). 

Different  computer  systems  handle  exceptions  in  different  ways;  some  more  elegantly  than  others. 

Exceptions  are  used  for  changing  the  flow  of  the  control  when  some  important  or  unexecpted  event, 
usaully  an  error,  occurs. 

Exceptions  devert  processing  to  a  part  of  the  program  that  can  try  to  handle  the  error,  (sort  of  like  a  goto 
statement....) 

The  "exception"  Control  Flow  Statement  is  used  to  handle  an  error  or  warn  potential  callers  of  the 
method  about  the  possiblity  of  an  error  via  a  throws  statement. 

In  past  programming  languages  the  programmer  would  try  to  solve  the  exception  problem  by  creating  an 
error  check  for  each  input: 

int    status    =   something_that_you_know_works ( ) ; 

if    (status    ==   Bad_return_value) 
{ 

switch (some_global_exception_indicator) 

{ 

handle_excepton_someway ; 


} 
} 


else 
( 

} 


all_is_well (continue_happily) ; 
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II  Fundamentals 

Exceptions  are  caused  in  one  of  two  ways: 


1.  Program  does  something  illegal  (usual  case).. Implicit  Exception: 

2.  Program  explicitly  generates  an  exception  by  executing  the  throw  statement  (less  usual  case). 

Here  is  the  basic  form  of  an  exception  handling  block: 

try  { 

//  block  of  code 
} 

catch  (  Except ionTypel  e)  { 

//  exception  handler  for  Except ionTypel 
} 

catch  (  Except ionType2  e)  { 

//  exception  handler  for  Except ionType2 

throw (e) ;  //  re- throw  the  exception 
} 

finally    { 

//    always    done 
} 
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III.  Exception  Types 

There  is  a  single  class  at  the  top  of  the  exception  class  hierarchy  called  Throwable  This  class  is  used  to 
represent  all  exceptional  conditions,  with  each  ExceptionType  in  general  a  subclass  of  Throwable. 

There  are  a  number  of  predefined  exceptions  in  the  Java  language: 

Class  Throwable  encompasses  objects  that  may  be  thrown  by  the  throw  statement. 

j  ava .  lang .  Throwable  is  the  root  class  of  the  Java  exception  and  error  hierarchy.  All  exceptions  and 

errors  that  are  thrown  are  subclasses  of  Throwable. 

The  hierarchy  of  classes  defined  in  package  java .  lang  are  as  follows, 
j  ava . lang . Throwable 

Error 

LinkageError 

ClassCircularityError 
ClassFormat Error 
Except ionlnlnitializerError 
Incompat  ibl eC 1 a  s  sChange  Er r o  r 

AbstractMethodError 

IllegalAccessError 

Inst ant iationError 

NoSuchFieldError 

NoSuchMethodError 
NoClassDefFoundError 
Unsatisf iedLinkError 


VerifyError 
VirtualMachineError 

Int  erna lError 

OutOfMemoryError 

StackOverf lowError 

UnknownError 
ThxeadDeath 
Exception 

ClassNotFoundException 
CloneNot Support edExcept ion 
IllegalAccessException 
Inst ant iationExcept ion 
Int  er rup t  edExc ep t  i on 
NoSuchMethodException 
Runt imeExcept ion 

ArithmeticException 
ArrayStoreException 

C la ssCa st Except ion 

I 1 legal Argument Except ion 

Number Forma t  Exc  ep t ion 
IllegalThreadStateException 

IndexOutOf BoundsException 

Negat  i veArrayS i  zeExc  ept  ion 

Null Pointer Except ion 

SecurityException 
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IV.  Uncaught  Exceptions 


Exception  objects  are  automatically  created  by  the  Java  runtime  in  response  to  some 
exceptional  condition.  For  example: 

class  ExcO  { 

public  static  void  main(String  args [ ] )  { 
int  d  =  0; 

int  a  =  42 /d;  //  exception,  divide  by  zero 
} 
} 


The  runtime  tries  to  execute  the  division,  causing  a  new  exception  object  to  throw  a 

We  say  throws  as  a  "hot  potato",  that  the  code  must  catch  and  deal  with  immediately. 

An  exception  handler  would  handle  this  exception,  but  in  this  example  we 
don't  have  an  exception  handler,  thus  it  defaults  to  the  runtime  handler. 
The  default  runtime  handler  then  prints  out  the  following: 

c : >  j  ava  Exc  0 

Java . lang.Arithmet icExcept ion :  /  by  zero 
at  ExcO .main (ExcO . Java: 4) 


Note:  The  name  ExcO,  method  name  main,  and  the  line  number  4  that  the  error  was  foun 


Also  the  Exception  that  was  thrown  was  called  ArithmeticException,  which  is  a   subcl 
of  Throwable . 

Another  example  is  the  same  class  which  introduces  the  same  error  but  in 
a  separate  method: 

class  Excl  { 

static  void  subroutine ()  { 
int  d  =  0; 
int  a  =  10  /  d; 

} 

public  static  void  main (String  args [ ] )  { 

Excl . subroutine ( ) ; 
} 
} 

The  call  stack  trace  from  running  Excl. Java  is: 

c : >  j  ava  Exc 1 

Java. lang.Arithmet icExcept ion :  /  by  zero 
at  Excl . subroutine (Excl . Java: 4) 
at  Excl .main (Excl . Java: 7 ) 

Note  that  the  bottom  of  the  stack  is  in  the  main  method,  line  7,  which  is  called 
form  line  4  of  the  subroutine ()  method. 
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V.  try  and  catch 


The  Java  runtime  handles  the  exception,  however  it  is  more  desirable  to  handle  the 
exception  yourself. 

Four  (4)  key  statements  associated  with  exceptions: 

•  try  -  runs  the  code  inside  the  braces,  if  there  is  an  error  then  use  the  catch 
to  tell  me  how  to  handle  them.  The  try  statement  governs  the  statements 
enclosed  within  it  and  defines  the  scope  of  any  exception  handlers  (established 
by  subsequent  catch)  associated  with  it. 

•  catch  -  allows  you  to  handle  any  and  all  exceptions  that  are  instances.  You 
associate  exception  handlers  with  a  try  block  by  providing  one  or  more 
sequential  catch  blocks  directly  after  the  try  block. 

•  throws  -  sort  of  like  a  break  statement,  nothing  beyond  it  is  executed. 

•  finally  -  used  to  perform  some  action  that  you  absolutely  have  to  do  (ie.  to 
free  some  external  resource)  To  be  sure  you  use  the  finally  statement.  Java's 
finally  statement  provides  a  mechanism  which  allows  your  method  to  cleanup 
after  itself  regardless  of  what  happens  within  the  try  block.  Use  the  finally 
statement  to  close  files  or  release  other  system  resources. 

For  now  lets  look  at  the  try  and  catch  statements. 

try 


{ 

do_something ( )  ; 
} 
catch  (SomeThrowableClassName  variableNames) 

{ 

do_something ; 
} 
catch  (SomeThrowableClassName  variableNames) 

{ 

do_something ; 
} 

Exc2.java  example  of  try  and  catch 

The  scope  of  the  catch  clause  is  restricted  to  those  statements  specified  by 
the  immediately  proceding  try  statement. 

Also,  it  is  advised  to  use  {  (begin  blocks)  and  }  (end  blocks)  with  try  and 
catch  to  make  the  code  more  readable. 
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VI.  Multiple  catch  Clauses 

In  some  cases  you  may  desire  to  have  more  than  one  exception  condition  raised. 

You  can  have  any  number  of  catch  clauses  in  a  row.  The  following  example  traps 
two  different  exception  types  followed  by  an  all-purpose  handler  for  all 
Throwable  types:  (page  170) 

Mult iCatch. Java  same  code 

Note:  This  example  catches  the  divide  by  zero  and  array  out  of  bounds 
exceptions . 
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VII.  Nested  try  Statements 


The  try  statement  nests  similar  to  variable  scope. 

You  can  wrap  a  try  statement  around  a  method  call,  and  inside  that  method, 
someother  try  statement  might  protect  some  other  code. 

Each  time  a  try  statement  is  entered,  the  context  of  that  exception  frame  is 
stacked  up  until  all  of  the  nexted  try  statements  complete. 

If  a  lower  level  try  statement  does  not  have  a  catch  handler  for  a  particular 
exception,  the  stack  is  unwound  and  the  next  try  statements  catch  are  inspected 
for  a  match.  This  continues  until  there  is  a  match,  else  it  hits  the  main 
method  and  a  runtime  error  is  generated. 

Here  is  a  graphic  example: 


6    / 
o 

O 


mainO  { 
-  carO; 
} 
►car(){ 

start_car0; 

startcarQ  { 
int  i ,  j  =  0; 

} 


Mult iNest .java,    page    170 


5.  if  the  exception  is  not  caught  by 
the  time  it  propagates  out  of  the  top 
of  the  program  then  execution  ceases 
and  an  error  message 


4.  returns  to  call  to  car0 


3.  here  method  car0  calls 
start  carO 


2.  runtime  system  looks  for 
an  enclosing  try.  .catch 
statement  here  in  start  carQ 

1.  divide  by  zero  exception 
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VIII.  throw 

The  throw  statement  is  used  to  explicitly  throw  an  exception. 
The  general  form  is  : 

throws  Except ionObj ect ; 


V 
throws  Java. io. IOExcept ion; 

The  Except ionObj ect  ( IOExcept ion)  is  an  object  of  a  class  that  extends  the 
class  java.lang. Except ion. 

The  flow  of  the  execution  stops  immediately  after  the  throw  statement,  and  the 
next  statement  is  not  reached. 

The  closest  try  block  is  inspected  to  see  if  it  has  a  catch  clause  which 
matches  the  type  of  the  Throwable  instance.  If  it  does,  then  control  is 
transferred  to  that  statement,  else  the  next  enclosing  try  statement  is 
inspected  and  so  on.. until  the  outermost  exception  handler  halts  the  program. 


Here  is  an  example  of  throwing  a  new  instance  of  an  exception: 
ThrowDemo . j  ava ,  page  17 1 
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IX.  throws 

If  a  method  is  capable  of  causing  an  exception  which  it  does  not  itself  handle, 
then  it  should  notify  the  methods  above  of  the  exception  so  that  callers  can 
guard  themselves  against  this  exception. 

The  throws  keyword  is  used  to  identify  the  list  of  possible  exceptions  that 
might  be  thrown  by  a  method. 

Here  is  an  example  of  a  program  that  tries  to  throw  an  exception  without  having 
any  code  to  catch  it,  nor  using  throws  to  declare  that  the  exception  will  be 
thrown.. this  will  not  compile: 

class  ThrowsDemol  { 

static  void  procedure  ()  { 

Sy stem. out .print In (" inside  procedure") ; 

throw  new  IllegalAccessException ( "demo" ) ;   //trys  to  throw  without  catch 
} 

public  static  void  main  (String  args [ ] )  { 

procedure ( ) ; 
} 


Inorder  to  make  this  compile  we  need  to  declare  that  procedure  throws 
IllegalAccessException  and  add  a  try  and  catch  statement. 

For  example : 

Thr ows Demo . Java,  pg  173 
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X.  finally 


When  exceptions  are  thrown,  the  flow  of  code  in  a  method  takes  a  non-linear 
flow  through  the  method,  skipping  lines. 

To  assure  that  a  given  piece  of  code  will  run  no  matter  what,  the  finally 
keyword  can  be  used  to  identify  a  block  of  code  to  always  be  executed.. ie 
closing  a  file  that  is  open. 

Even  if  there  is  no  catch  clause,  the  finally  statement  will  be  executed  before 
the  code  block  ends . 

The  finally  statement  is  not  manditory,  but  optional. 


Here  is  an  example: 
Final lyDemo. Java,  pg  174 
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XL  Exception  Subclasses 


Java  allows  the  use  of  User-Defined  Exceptions  created  to  uniquely  handle 
possible  errors  in  execution. 

Only  subclasses  of  class  Throwable  may  be  caught  or  thrown.  Simple  types,  such 
int  or  char,  as  well  as  non- Throwable  classes  such  as  String  and  Object  may  not 
be  used  as  exceptions. 

For  example : 

class  OutofGas  extends  Exception  { 

System. out .println ( "Exception  here") ; 
} 

class  car  { 

//  do  something 

if  (fuellevel  <  0.5)  throw  new  OutofGas () ;   //  throw  exception 

} 

Any  method  that  throws  a  User-Defined  exception  must  also  catch  it.  The 
advantage  of  using  exceptions  is  that  you  can  collect  all  errors  in 
well-localized  places  in  your  program. . .however,  it  does  not  always  reduce  the 
work. 

Another  example: 

Except ionDemo . Java,  pg  17  5 
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XII.  Summary  of  Exceptions 

O  Purpose:  Safer  programming  by  providing  a  distinct  path  to  deal  with 
errors 

O  Do  Use  Them:  They  provide  a  useful  tool  for  organizing  error  handling. 

O  Exceptions'  main  use  is  to  get  a  decent  error  message  out  explaining  what 
failed  and  where  and  why.  Exceptions  don't  take  all  the  work  out  of 
finding  errors,  but  they  do  allow  you  to  put  errors  in  neat 
packages .. .thus  handling  the  errors  and  exceptions. 
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Classes 

A  Java  program  is  a  collection  of  class  definitions. 

A  class  definition  has  the  form 

class   classname    [extends    super c las sname]     { 
type  varl ; 
type  var2 ; 
type  varN; 

type  methodnamel (parameter-list)     { 
method-body; 

} 

type  methodname2 (parameter-list)  { 
method-body; 

} 

type  methodnameN (parameter-list )  { 
method-body ; 

} 
} 

Unlike  C++,  class  declarations  and  method  implementations  are  not  separated. 

Instances  of  classes  are  created  at  run  time  and  are  called  objects. 

Instance  Variables 

Variables  varl,  var2,...,  varN  are  called  instance  variables. 

Every  instance  of  the  class  has  its  own  set  of  these  variables. 

class  Point  { 

int  x,  y; 

} 

Every  instance  of  Point  has  a  variable  called  x  and  one  called  y. 

How  do  we  create  instances  of  a  class?  By  the  new  operator. 

The  new  operator  creates  a  single  instance  of  a  class  and  returns  a  reference  to  that  object.  The  instance 
variables  of  the  object  are  accessed  using  dot  notation. 

Point  p  =  new  Point (  );  //  creates  a  new  instance  of  Point;  reference  stored  in  p 

Point  p2  =  p;  //  P  and  p2  now  store  a  reference  to  the  same  object 

p2.x  =  17;  //  p.x  ==  p2.x  ==  17 

Point  p3  =  new  Point (  ) ; 

p3.x    =    5;  //    p2.x    ==    17      ScSc   p3  .x    ==    5 

p    =   null;  //    p2.x    ==    17 


p.x  =  p2.x;  //  throws  NullPointerException 

Two  instances  of  Point  are  created  in  class  TwoPoints.java. 

Object  cloning 

We  can  redefine  Point  to  implement  class  Cloneable  so  that  copies  of  Point  objects  are  possible: 

class  Point  implements  Cloneable  { 
int  x,  y; 
public  Object  clone (  )  { 

Point  p  =  new  Point (  ) ; 
p.x  =  this.x; 
p.y  =  this.y; 
return  p; 
} 
} 
class  CloneDemo  { 

public  static  void  main (String  args  [  ])  { 
Point  pi  =  new  Point (  ) ; 
pl.x  =  16; 

Point  p2  =  (Point)  pi. clone (  ); 

pl.x  =  32; 

System. out .println( "p2 .x  =  "  +  p2.x);    //  outputs  16 

} 
} 

Java  records 

Java  has  no  traditional  records  (structures).  Instead  one  uses  classes  with  instance  variables. 

class  LinkedList  { 
int  x; 

LinkedList  next; 
} 
class  ListDemo  { 

public  static  void  main (String  args [  ])  { 

LinkedList  myList  =  new  LinkedList (  ); 

myList.x  =  16; 

myList. next  =  new  LinkedList(  ); 

myList .next .x  =  32; 

myList .next .next  =  null; 

for (LinkedList  p  =  myList;  p  !=  null;  p  =  p. next) 

System. out .println (p.x) ;         //  outputs  16,  32 

} 
} 

Instance  Method  Declaration  and  Access 

In  addition  to  instance  variables,  classes  may  contain  instance  methods. 

class  Point  { 

int  x,  y; 

void  init(int  a,  int  b)  {       //an  instance  method 
x  =  a; 


y   =   b; 

} 
} 
class   PointDemo    { 

public    static   void  main (String  args [    ])     { 
Point   p    =   new  Point (    ) ; 

p.init(10,    20);    //    call   p's   init   instance  method 
} 
} 

As  another  example,  consider  a  circle  class  with  two  instance  methods: 

class  Circle  { 

double  x,  y;     //  center 

double  r;        //  radius 

//  two  instance  methods 

double  circumference (  )  {  return  2  *  3.14159  *  r; } 

double  area(  )  {return  3.14159  *  r  *  r;} 

} 

class  CircleDemo  { 

public  static  void  main (String  args  [  ]  )  { 

Circle  c  =  new  Circle (  ) ; 

double  a; 

c.x  =  2.0, 

c.y  =  2.0 

c.r  =  1.0. 

a  =  c . area (  );   //  access  c's  instance  method  area (  ) 
} 
} 

Instance  Methods  and  "this" 

An  instance  method  is  implemented  with  an  implicit  argument  called  this: 

double   circumference (Circle   this)     {    return   2    *    3.14159    *    this.r;} 
double   area (Circle   this)     {return   3.14159    *    this.r   *    this.r;} 
Circle   c    =   new  Circle (    ); 
a   =   area (c)  ; 

this  is  not  explicit  in  instance  method  signatures  because  it  is  assumed  that  when  a  method  accesses  any 
instance  variable  or  method  in  its  class,  it  is  accessing  the  fields  in  the  object  referred  to  by  the  this 
argument. 

In  some  cases,  this  is  required  for  scope  resolution: 

class  Point  { 

int  x,  y; 

void  init (int  x,  int  y)  { 
this.x  =  x; 
this.y  =  y; 
} 
} 

Constructors 

A  constructor  is  a  special  method  for  initializing  an  object  immediately  upon  creation.  It  has  the  same 


name  as  the  class  in  which  it  appears  and  has  NO  RETURN  TYPE. 
A  constructor's  job  is  to  initialize  all  internal  state. 
Three  examples  of  constructors 

1.  class  Point  { 

int  x,  y; 

Point (int  x,  int  y)  {    //a  constructor  method 
this.x  =  x; 
this.y  =  y; 
} 
} 
class  PointDemo  { 

public  static  void  main(String  args [  ])  { 

Point  p  =  new  Point(10,  20); 
} 
} 

2.  class  Circle  { 

double  x,  y,  r; 

Circle (double  x,  double  y,  double  r)  {  //a  constructor  method 

this.x  =  x; 

this.y  =  y; 

this.r  =  r; 
} 

//  two  instance  methods 

double  circumference (  )  {  return  2  *  3.14159  *  r;} 
double  area!  )  {return  3.14159  *  r  *  r;} 
} 
class  CircleDemo  { 

public  static  void  main (String  args  [  ] )  { 

Circle  c  =  new  Circle (2.0,  2.0,  1.0); 

double  a; 

a  =  c . area (  ) ; 
} 
} 

3.  class  LinkedList  { 

int  x; 

LinkedList  next; 

LinkedList (int  x,  LinkedList  p)  {        //a  constructor  method 

this.x  =  x; 

this. next  =  p; 
} 
} 
class  ListDemo  { 

public  static  void  main (String  args [  ])  { 

//  LinkedList  myList  =  new  LinkedList (  ); 

//  myList.x  =  16; 

//  myList. next  =  new  LinkedList (  ) ; 

//  myList .next .x  =  32; 

//  myList .next .next  =  null; 

LinkedList  myList  =  new  LinkedList (16 ,  new  LinkedList (32 ,  null) 

for (LinkedList  p  =  myList;  p  !=  null;  p  =  p. next) 
System. out .println (p. x) ; 


} 

Destructors 

The  Java-equivalent  notion  of  the  C++  destructor  is  the  instance  method  finalize. 

It  is  executed  just  before  an  object  of  the  class  is  garbage  collected. 

Used  to  free  up  system  resources  like  I/O  streams  (file  descriptors  and  sockets),  but  not  memory  since  it 
is  reclaimed  by  the  runtime  system. 

Here  is  the  finalizer  method  from  FileOutputStream: 

protected  void  finalize (  )  throws  IOException  { 

if  (fd  !=  null)  close (  )  ; 
} 

The  Default  Constructor 

If  a  constructor  is  not  defined  for  a  class,  then  the  default  constructor  is  automatically  inserted  which 
merely  calls  the  superclass  constructor: 

Point (    )     { super (    ) ; }  //    call    to   empty   constructor  Object (    ) 

Circle (    )     { super (    ) ; } 

Method  Overloading 

The  same  name  can  be  used  for  more  than  one  method  —  called  method  overloading. 

Overloaded  names  are  resolved  through  a  method's  type  signature,  as  in  Ada. 

A  type  signature  comprises  a  method's  arity  and  parameter  types. 

The  name  "Point"  is  overloaded  in  the  constructor  methods  of  PointCreateAlt.java. 

The  second  definition  of  Point: 

Point (    )     {x   =  y   =    -1;} 

can  be  rewritten  using  this  as 

Point (  )  {this(-l,  -1);}         //  call  to  first  Point  constructor 

Use  of  this  within  a  constructor  is  RESTRICTED  to  appear  as  the  first  statement. 

The  reason  is  to  ensure  that  all  superclass  constructors  are  executed  first  so  that  the  state  they  control  is 
initialized. 

Method  overloading  is  not  limited  to  constructors. 

See  overloading  of  "distance"  method  in  PointDist.java. 


Class  Extension 

Class  extension  allows  one  class  to  inherit  the  instance  variables  and  methods  of  another  class  (single 
inheritance). 

A  class'  immediate  parent  is  called  its  superclass. 

class  Point  { 
int  x; 
int  y; 
public  boolean  equal (Point  p)  { 

return  (x==p.x  &&  y==p.y) ; 
} 
} 

class  ColPoint  extends  Point  { 
int  color; 
//  overload  equal 
public  boolean  equal (ColPoint  p)  { 

return  (super .equal (p)  &&  color==p. color) ;   //  x==p.x  &&  y==P-y  &&  color==p. colo 
} 
} 
public  class  ColoredPoints  { 

public  static  void  main ( String [ ]  args)  { 
ColPoint  cp  =  new  ColPoint (  ) ; 
Point  p  =  new  Point (  ) ; 

System. out .println(cp. equal (p) ) ; 

} 
} 

Contrast  the  use  of  super  above  with  its  use  as  a  constructor  in  Point3D.java. 
Method  Overriding 

When  a  class  defines  a  method  using  the  same  name,  return  type,  and  arguments  as  a  method  in  its 
superclass,  the  method  in  the  class  overrides  the  method  in  the  superclass. 

The  new  method  is  called  for  objects  of  the  class,  not  the  superclass'  old  definition. 

class  A  { 

int  i  =  1; 

int  f(  )  {return  i;} 
} 
class  B  extends  A  { 

int  i  =  2 ;  //  shadows  variable  i  in  class  A 

int  f(  )  {  //  overrides  method  f  in  class  A 

i  =  super . i  +  2 ; 
return  super . f (  )  +  i ; 
} 
} 
class  OverRideDemo  { 

public  static  void  main(String  args [  ])  { 
B  b  =  new  B (  ) ; 

System. out .print In (b. i) ;         //  outputs  2 
System. out .println( ( (A) b) . i) ;    //  outputs  1 


System. out .print In (b. f (  ) ) ;      //  outputs  4 
} 

} 

Now  take  a  look  at  the  example  in  Point3DDist.java. 

The  preceding  example  can  be  explained  by  making  this  explicit: 

class  Point  { 

int  x,  y; 

Point (Point  this,  int  x,  int  y)  { 

this.x  =  x; 

this.y  =  y; 
} 
double  distance (Point  this,  int  x,  int  y)  { 

int  dx  =  this.x  -  x; 

int  dy  =  this.y  -  y; 

return  Math.sqrt(dx  *  dx  +  dy  *  dy) ; 
} 
double  distance (Point  this,  Point  p)  { 

return  distance (this,  p.x,  p.y);         //  dynamic  method  dispatch  h 
} 
class  Point3D  extends  Point  { 
int  z  ; 
Point3D(Point3D  this,  int  x,  int  y,  int  z)  { 

super(this,  x,  y) ; 

this.z  =  z; 
} 
double  distance (Point3D  this,  int  x,  int  y,  int  z)  { 

int  dx  =  this.x  -  x; 

int  dy  =  this.y  -  y; 

int  dz  =  this.z  -  z; 

return  Math.sqrt(dx  *  dx  +  dy  *  dy  +  dz  *  dz)  ; 
} 
double  distance (Point3D  this,  Point3D  other)  { 

return  distance (this,  other. x,  other. y,  other. z); 
} 
double  distance (Point3D  this,  int  x,  int  y)  { 

double  dx  =  (this.x  /  z)  -  x; 

double  dy  =  (this.y  /  z)  -  y; 

return  Math.sqrt(dx  *  dx  +  dy  *  dy)  ; 
} 
class  Point3DDist  { 

public  static  void  main(String  args  [  ])  { 

Point3D  pi  =  new  Point3D(30,  40,  10); 

Point  p  =  new  Point (4,  6); 

.  .  .  distance (pi,  p)  .  .  . 
} 
} 

Dynamic  method  dispatch  takes  place  among  instance  methods  that  are  defined  with  the  same  name  in 
subclasses  of  a  given  class. 

Above,  we  have  Point3D  is  a  subclass  of  Point,  so  distance(pl,  p)  results  in  a  call  to  the  first  distance 
method  of  Point. 

The  call  distance(this,  p.x,  p.y)  is  not  resolved  statically  as  one  might  expect  with  this  having  type 
Point. 


Instead  the  call  is  resolved  dynamically  by  retaining  at  runtime,  the  type  of  the  object  whose  reference  is 
stored  in  this,  namely  Point3D. 

Notice  that  technically  speaking,  2D  distance  is  not  really  overridden  by  the  definition  given  in  Nutshell 
(pg.  68)  since  the  first  distance  definition  in  Point  and  the  third  given  in  Point3D  actually  have  different 
type  signatures  when  this  is  made  explicit! 

As  another  example  of  dynamic  method  dispatch,  see  Dispatch.java. 
Final  instance  methods  and  variables 

All  instance  variables  and  methods  can  be  overridden  by  default. 

To  prevent  one  of  these  from  being  overridden,  use  the  final  qualifier. 

The  following  is  taken  from  class  ThreadGroup: 

public  final  String  getName (  )  ; 
public  final  ThreadGroup  getParent (  ) ; 
public  final  synchronized  void  stop(  ) ; 

final  is  also  used  to  prevent  a  class  from  being  extended: 

public  final  class  String  extends  Object  {.  .  .} 

Using  final  in  these  ways  is  aimed  at  preventing  Java  programs  from  extending  Java's  built-in  methods 
in  malicious  ways  that  could  compromise  security. 

It  may  also  be  used  for  a  more  traditional  purpose:  to  get  constants: 

final  int  FILE_NEW  =1;         //  final  instance  variables 
final  int  FILE_QUIT  =  5 ; 

Finally,  all  static  and  private  methods  are  implicitly  final. 

Class  Variables  and  Methods 

So  far  we  have  considered  only  instance  variables  and  instance  methods. 

Each  object  has  its  own  instance  of  an  instance  variable  and  its  own  instance  of  an  instance  method. 

There  is  another  kind  of  variable  called  a  class  variable  and  another  kind  of  method  called  a  class 
method.  Each  is  indicated  as  such  in  Java  using  the  keyword  static. 

Class  variables 

A  class  variable  is  shared  among  all  instances  of  a  class.  Only  one  copy  of  the  variable  exists  regardless 
of  the  number  of  instances  of  the  class  that  are  created. 


public  class  Circle  { 

static  int  num_circles  =0;      //  counter  class  variable 

public  static  final  double  PI  =  3.14159265;      //  final  class  variable 

public  double  x,  y,  r; 

public  Circle (double  x,  double  y,  double  r)  { 
this.x  =  x;  this.y  =  y;  this.r  =  r; 

num_circles++;   //no  need  to  say  Circle. num_circles  within  class 
} 
} 
public  class  CircleDemo  { 

public  static  void  main (String  args  [  ])  { 

System. out .println (Circle. num_circles) ;  //  no  instance  of  Circle  nee 
double  circum  =  2  *  Circle. PI  *  radius;  //or  here 
} 
} 

Class  methods 

Class  methods  differ  from  instance  methods  in  that  they  ARE  NOT  PASSED  AN  IMPLICIT  this 
reference. 

These  methods  are  not  associated  with  any  instance  of  the  class.  There  is  only  ONE  copy  for  all 
instances. 

This  means  that  class  methods 

1.  cannot  call  instance  methods 

2.  cannot  access  instance  variables 

3.  cannot  refer  to  this  or  super 

4.  can  have  their  calls  optimized  by  inlining  method  byte  codes 

We  have  already  seen  an  example  of  a  class  method:  Math.sqrt( ).  In  fact,  EVERY  method  in  class  Math 
is  a  class  method  (see  pg.  317  of  Nutshell). 

As  another  example,  consider 

public    final   class   System  extends   Object    { 
public    static    PrintStream  out; 

} 

public  class  PrintStream  extends  FilterOutputStream  { 

public  synchronized  void  println(char  c) ; 

public  synchronized  void  println (String  s) ; 

} 

Abstract  methods 

Java  lets  you  specify  a  method  without  defining  it  by  making  it  abstract. 

Abstract  methods  are  used  when  you  wish  to  specify  the  operations  of  a  class  but  do  not  have  enough 
information  to  actually  define  them. 


public  abstract  class  Shape  { 

public  abstract  double  area (  ) ; 

public  abstract  double  circumference (  ) ; 

} 

public  class  Circle  extends  Shape  { 

double  r; 

static  final  double  PI  =  3.14159265; 

public  double  area (  )  {return  PI  *  r  *  r;} 

public  double  circumference (  )  {return  2  *  PI  *  r;} 

} 

public  class  Rectangle  extends  Shape  { 
double  w,  h; 

public  double  area (  )  {return  w  *  h;} 
public  double  circumference (  )  {return  2  *  (w  +  h) ; } 

} 

Some  facts  to  remember  about  abstract  methods: 

1.  Any  class  with  an  abstract  method  is  abstract  itself. 

2.  An  abstract  class  may  define  some  non-abstract  methods. 

3.  An  abstract  class  cannot  be  instantiated. 

4.  A  subclass  of  an  abstract  method  can  be  instantiated  if  it  defines  every  abstract  method  of  its 
superclass. 

See  the  class  methods  in  Static.java  and  StaticByName.java. 
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Interfaces 

Class  extension  in  Java  provides  single  inheritance  only. 

That  is,  a  class  can  inherit  method  implementations  from  exactly  one  superclass. 

Multiple  inheritance  allows  for  a  class  to  inherit  method  implementations  from  one  or  more 
superclasses,  as  in  C++. 

The  Java  designers  feel  that  inheriting  multiple  method  implementations  is  not  all  that  useful. 

However,  the  Java  designers  do  feel  that  inheriting  multiple  method  signatures  is  useful. 

Think  of  a  method  signature  as  the  method's  name,  parameters,  and  return  type. 

To  support  this  kind  of  inheritance,  Java  uses  interfaces. 

An  interface  is  an  abstract  class. 

An  abstract  class  may  define  some  non-abstract  methods,  however,  all  the  methods  in  an  interface  are 
implicitly  abstract. 

Example 

Recall  the  abstract  classes: 

public  abstract  class  Shape  { 

public  abstract  double  area (  ) ; 

public  abstract  double  circumference (  ) ; 
} 
public  class  Circle  extends  Shape  { 

protected  double  r; 

Circle (  )  (r  =  1.0;} 

Circle (double  r)  {this.r  =  r;} 

static  final  double  PI  =  3.14159265; 

public  double  area (  )  {return  PI  *  r  *  r;} 

public  double  circumference (  )  {return  2  *  PI  *  r; } 
} 
public  class  Rectangle  extends  Shape  { 

protected  double  w,  h; 

Rectangle (  )  {this (0.0,  0.0);} 

Rectangle (double  w,  double  h)  { 
this.w  =  w; 
this.h  =  h; 

} 

public  double  area (  )  {return  w  *  h; } 

public  double  circumference (  )  {return  2  *  (w  +  h) ; } 
} 

And  we  can  use  them  as  follows: 


Shape [  ]  shapes  =  new  Shape [  3  ]  ; 
shapes [0]  =  new  Circle (2.0); 
shapes [1]  =  new  Rectangle (1 . 0,  3.0); 
shapes [2]  =  new  Rectangle (4 . 0 ,  2.0); 

double  total_area  =  0; 

for  (int  i  =  0;  i  <  shapes . length;  i++] 
total_area  +=  shapes [i] .area ( 


//  dynamic  dispatch 


Now  suppose  we  wish  to  extend  our  package  of  shapes  by  allowing  them  to  be  drawn.  So  we  do  the 
following: 

public  abstract  class  DrawableShape  { 

public  abstract  void  setColor (Color  c) ; 

public  abstract  void  setPosition (double  x,  double  y)  ; 

public  abstract  void  draw ( DrawWindow  dw) ;        //DrawWindow  defined  elsewhe 
} 
public  class  DrawableRec tangle  extends  DrawableShape  { 

private  protected  double  w,  h; 

private  protected  Color  c; 

private  protected  double  x,  y;   //  position 

DrawableRectangle (double  w,  double  h)  { 
this.w  =  w; 
this.h  =  h; 

} 

public  double  area (  )  {return  w  *  h; } 

public  double  circumference (  )  {return  2  *  (w  +  h) ; } 

//  define  abstract  methods  of  DrawableShape 
public  void  setColor (Color  c)  {this.c  =  c;} 
public  void  setPosition (double  x,  double  y)  { 

this.x  =  x; 

this.y  =  y; 
} 
public  void  draw (DrawWindow  dw)  { 

dw.drawRect (x,  y,  w,  h,  c) ; 
} 
} 

But  we  don't  want  to  duplicate  Rectangle's  variables  and  methods,  namely  w,  h,  area( )  and 
circumference ( ),  as  above. 

Instead,  we  should  inherit  them  from  Rectangle. 

But  we  can't  since  that  would  require  we  write 

public   class   DrawableRectangle   extends   Rectangle  DrawableShape    {    .     .     .    } 
which  is  illegal  in  Java. 

So  we  introduce  an  interface  called  Drawable:: 

public  interface  Drawable  { 

public  void  setColor (Color  c)  ; 

public  void  setPosition (double  x,  double  y)  ; 

public  void  draw ( DrawWindow  dw) ; 


} 

public  class  DrawableRec tangle  extends  Rectangle  implements  Drawable  { 
private  protected  Color  c; 

private  protected  double  x,  y;   //  position 
DrawableRec tangle (double  w,  double  h)  {super (w,  h) ; } 

//  define  abstract  methods  of  Drawable  interface 
public  void  setColor (Color  c)  {this.c  =  c;} 
public  void  setPosition (double  x,  double  y)  { 

this.x  =  x; 

this.y  =  y; 
} 
public  void  draw ( DrawWindow  dw)  { 

dw.drawRect (x,  y,  w,  h,  c)  ; 
} 


And  now  we  can  use  the  above  definitions  as  follows: 

Shape [  ]  shapes  =  new  Shape [2]; 
•Drawable [  ]  drawables  =  new  Drawable [2] ; 

shapes [0]  =  drawables [0]  =  new  DrawableCircle (1 . 1) ; 

shapes [ 1 ]  =  drawables [ 1 ]  =  new  DrawableRectangle (2.3,  4.5); 

double  total_area  =  0; 

for  (int  i  =  0 ;  i  <  shapes . length;  i++)  { 

total_area  +=  shapes [i] .area (  );         //  dynamic  dispatch 

drawables [i] . setPosition (i  *  10,  i  *  10); 

drawables [i] .draw(draw_window) ;  //draw_window  defined  elsewhere 
} 
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Packages 

In  Java,  class  definitions  are  organized  using  packages. 

Every  class  belongs  to  a  package. 

The  package  to  which  it  belongs  is  specified  by  a  package  declaration: 

package  pkgl  [ .  pkg2  [ .  pkgn  ]  ]; 

For  example,  we  declare  class  Hashtable  to  be  in  package  java.util  by 

package  java.util; 

public  class  Hashtable  extends  Dictionary  implements  Cloneable  { 
//  see  page  343  of  Nutshell 

} 

A  package  is  merely  a  directory,  and  the  "dots"  indicate  subdirectories. 

On  UNIX  systems,  Hashtable  must  be  in  directory  java/util. 

On  Windows/NT  platforms,  Hashtable  is  in  java\util. 

java.util  is  a  relative  path  that  is  resolved  with  respect  to  a  platform-dependent  default  path,  for 
example,  c:\java\classes.  This  is  true  of  system  classes,  i.e.  those  in  the  package  "Java". 

User-defined  packages  are  resolved  with  respect  to  the  CLASSPATH  environment  variable. 

package  Sets. Heap; 
class  Heap  {  .  .  .  } 

package  Sets .BitVector ; 
class  BitVector  {  .  .  .  } 

If  CLASSPATH  is  ".;c:\myjava",  then  class  Heap  must  be  in  c:\myjava\Sets\Heap  and  BitVector  in 
c:\myjava\Sets\BitVector. 

To  use  these  classes,  one  writes 

Sets. Heap  si  =  new  Sets. Heap (  ); 

Sets. BitVector  s2  =  new  Sets .BitVector (  ); 

Java  permits  path  names  to  be  abbreviated  using  import: 

import  Sets. Heap; 
import  Sets .Bitvector ; 
Heap  si  =  new  Heap (  ) ; 
BitVector  s2  =  new  Bitvector (  ); 


which  can  be  abbreviated  still  further  as 

import  Sets . * ; 

Heap  si  =  new  Heap (  ) ; 

BitVector  s2  =  new  Bitvector(  ) ; 

In  general,  a  class  path  pkgl.pkg2.pkgn.classname  can  be  written  as  just  classname  providing  there  is  an 
import  statement  of  the  form 

import  pkgl.pkg2.pkgn.classname 

import  declarations  are  merely  a  notational  shorthand.  They  are  NOT  needed. 

Access  protection 

Java  provides  control  over  the  visibility  of  variables  and  methods. 
Control  is  exercised  at  three  levels: 

1.  classes 

2.  subclasses 

3.  packages 

See  the  table  on  page  134  of  the  Java  Handbook. 

The  places  from  which  one  wishes  to  "see"  definitions  are 

1 .  same  class 

class  C  { 

int  i ; 

int  f(  )  {  return  i ; }    //  can  f  see  i  ? 
} 

2.  same  package  subclass 

//  in  a  source  file 
package  p; 
class  C  { 

int  i  ; 
} 

//in  another  source  file 

package  p; 

class  D  extends  C  { 

int  f(  )  {return  i;}  //  can  f  see  i  ? 

} 

3.  same  package  non-subclass 

//  in  a  source  file 
package  p; 
class  C  { 


int   i  ; 

} 

//in  another   source   file 
package  p; 
class   D    { 

int    f(    )     {return   i;}  //    can   f    see    i    ? 

} 

4.  different  package  subclass 

//  in  a  source  file 
package  p; 
class  C  { 

int  i  ; 
} 

//in  another  source  file 

package  q; 

class   D  extends   C    { 

int    f(    )     {return   i;}  //    can   f    see   i    ? 

} 

5.  different  package  non-subclass 

//  in  a  source  file 
package  p; 
class  C  { 

int  i  ; 

} 

//  in  another  source  file 

package  q; 

class  D  { 

int  f(  )  {return  i;}  //  can  f  see  i  ? 

} 

The  access  modifiers  are 

1 .  private  -  visible  in  class  only 

2.  public  -  visible  everywhere 

3.  protected  -  visible  in  package  and  subclasses 

4.  private  protected  -  visible  in  subclasses 

5.  the  default  -  visible  in  package 

See  the  example  in  Protection.java  and  Protection2.java. 
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File  &  FilenameFilter  classes 


File 

The  File  object  enables  the  assignment  of  a  handle  via  the  java.io  package  by  which  the  programmer  can 
access  information  about  actual  physical  files.  It  can  access  certain  properties  of  the  files  and  the  file 
system  but  does  not  deal  with  how  information  is  stored,  that  is  left  to  the  operating  system. 

As  in  Unix,  Java  treats  directories  as  files  that  have  lists  of  filenames  in  them.  Regular  files  have  many 
properties  that  the  Java  File  object  can  access  thru  methods  including  existence,  readability,  size,  type 
and  time  of  creation. 
(See  Nutshell  p.  296  for  a  complete  description) 

The  following  code  (from  p.  221  of  Handbook)  demonstrates  some  of  the  properties  of  a  File  object. 

import  java.io.*; 
class  FileTest  { 

private  static  void  p( String  s)  { 
System. out .print In (s) ; 

} 

public  static  void  main (String  args [ ] )  { 

File  fl  =  new  File (" /Java" ) ; 

Java. util. Date  d  =  new  Java .util .Date (fl . las tModified( )) ;  //for  fun 


"File  Name:"  +  f 1 .getName ( ) ) ; 

"Path:"  +  fl.getPathO  )  ; 

"Platform  Path  Separator:  "+  fl . separator) ; 

"Current  directory:  "+  System. get Property ( "user . dir " ) ) 

"Abs  Path:"  +  f 1 .getAbsolutePath ( ) ) ; 

"Parent:"  +  f 1 .getParent ( ) ) ; 

fl.exists()  ?  "exists"  :  "does 

f 1 .canWrite ( )  ?  "is  writeable" 

fl.canReadO  ?  "is  readable"  : 

"is  "  +  (fl.isDirectoryO  ?  "" 

fl.isFileO  ?  "is  normal  file" 

fl.isAbsolute( )  ?  "is  absolute 


"File  last  modified 
"File  last  modified 
"File  last  modified 


not  exist" ) ; 

:  "is  not  writeable"); 

"is  not  readable"); 

:  "not  ")  +  "a  directory") 

:  "might  be  a  named  pipe") 
:  "is  not  absolute"); 
fl.lastModifiedO ) ; 
d.  toString( ) ) ; 
d . toLocaleString ( ) ) ; 


'File  size:"  +  f 1. length ()  +  "  Bytes") 


} 


Note:  enhanced  and  corrected  from  text. 
Sample:  FileTest.java 


Sample:  Ren  Java  renames  an  existing  file. 

Top 


FilenameFilter 

This  class  filters  out  filenames  based  on  filename  pattern  matching.  This  can  also  work  on  the  read  or 

write  flags  of  a  file.  It  uses  the  accept  method  which  is  called  on  every  item  in  the  list.  This  interface  is 

implemented  in  the  AWT  FileDialog  object  and  the  list  method  of  File. 

(From  Handbook,  p. 222-223) 

The  authors  DirList.java 

Sample:  DirList.java 

Sample:  OnlyExt.java 

Top 
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Streams  Overview 


A  stream  is  an  abstract  concept  that  refers  to  the  movement  of  data  from  one  point  to  another.  We 
typically  think  of  this  data  as  a  sequence  of  bytes  which  we  can  either  read  or  write.  The  bytes  are 
frequently  read  from  or  written  to  a  file,  but  other  devices  such  as  network  connections  or  memory 
blocks  are  handled  in  essentially  the  same  way. 

Two  basic  abstract  types: 
InputStream  and  OutputStream 

InputStream  is  the  superclass  of  all  input  streams.  These  methods  will  throw  an  iOException  on  error. 
An  input  stream  is  automatically  opened  when  you  create  it.  Each  subclass  has 

•  read  ( )  reads  the  next  byte  of  data  on  the  stream. 

•  read  (byte  b  [  ] )  reads  into  an  array  of  bytes,  returns  number  read. 

•  read  (byte  b[],    int  off,    int  len)  starts  at  offset,  reads  into  an  array, 
all  read  ( )  methods  return  -1  at  the  end  of  the  stream. 

•  skip   (long  n)  skips  n  bytes  and  returns  actual  number  skipped. 

•  available  ( )  returns  number  of  bytes  available  without  blocking.(threads) 

•  close  ( )  closes  the  stream  and  frees  resources. 

•  marksupported  ( )  returns  true  if  supported. 

•  mark   (int  readiimit)  marks  current  position  in  the  stream. 

•  reset  ( )  returns  stream  pointer  to  lastmarkposition. 

OutputStream  provides  the  basic  output  methods  for  all  subclasses.  An  output  stream  is  automatically 
opened  when  you  create  it.These  methods  all  return  void  and  throw  iOException  on  error. 

•  write  ( int  b)  writes  a  single  byte  to  the  stream. 

•  write  (byte  b  [  ] )  writes  an  entire  array  of  bytes  to  the  stream. 

•  write  (byte  b[],   int  off,   int  len)  writes  a  subarray  to  the  output  stream. 

•  close  ( )  closes  the  output  stream. 

•  flush  ()  clears  the  output  stream. 

Beneath  these  abstract  classes  are  more  refined  stream  types: 

•  File  Streams 

•  Filtered  Streams: 

O  Print  Streams 
O  Data  Streams 
O  Buffered  Streams 

•  SequencelnputStream 

•  RandomAccessFile 


•  Piped  Streams 

File  Streams: 

The  FilelnputStream  and  FileOutputStream  classes  are  used  to  read  and  write  data  to  actual  files  in 
a  host  system. 

FilterlnputStream  and  FilterOutputStream  are  subclasses  of  InputStream  and  OutputStream, 
respectively,  and  are  both  themselves  abstract  classes.  These  classes  define  the  interface  for  filtered 
streams.  Filtered  streams  process  the  data  as  its  being  read  or  written. 

Print  Streams: 

Extends  FilterOutputStream  to  print  textual  representations  of  all  primitve  data  types.  Uses 
print  ( )  and  println  ( )  to  output  the  text.  Print  in  ( )  follows  the  text  with  a  newline.  An  object 
is  converted  with  its  tostring  method  before  printing.  This  method  is  used  by  the  System,  out 
variable.  Note  that  this  class  may  not  print  all  Unicode  characters 

Data  Streams: 

Used  to  read  and  write  many  primitive  Java  types  from  or  to  the  respective  stream  in  platform 
independent  binary  format.  DataOutputStream  does  not  handle  Strings.  Example  of  keyboard 
echo. 

Buffered  Streams: 

Provide  data  buffering  to  increase  efficiency.  When  writing  data  to  a  physical  device  or  memory 
block,  multiple  accesses  may  take  longer  than  waiting  for  the  buffer  to  fill,  then  going  to  the  disk. 
The  size  of  the  buffer  may  be  specified,  else  it  defaults  to  32  bytes.  By  setting  up  a  such  an  input 
stream,  an  application  can  read  bytes  from  a  stream  without  necessarily  causing  a  call  to  the 
underlying  system  for  each  byte  read.  The  data  is  read  by  blocks  into  a  buffer;  subsequent  reads 
can  access  the  data  directly  from  the  buffer. 

Example  of  code  using  streams: 

FilelnputStream  in  =  null; 
DatalnputStream  dataln  =  null; 
Buf feredlnputStream  bis  =  null; 

in  =  new  FilelnputStream (args [1] ) ; 
bis  =  new  Buf feredlnput Stream (in) ; 
dataln  =  new  DatalnputStream ( bis ) ; 

OR 

DatalnputStream  dataln   = 
new  DatalnputStream (new  Buf feredlnputStream (new  FilelnputStream (args [1] ))) ; 

SequencelnputStream 

Creates  a  single  input  stream  on  multiple  input  sources. This  example  concatenates  two  files  to  the 
console:  Concatenate  Java  uses  ListOfFiles.java. 

RandomAccessFile: 

Though  not  a  stream  at  all,  this  class  implements  Datalnput  and  DataOutput  and  allows  the  reading 


and  writing  of  any  mixture  of  datatypes  to  any  location  in  a  file.  This  object  has  a  mode  associate 
with  it,  either  "r"  or  "rw"  for  read  only  or  read-write.  A  physical  filename  or  object  is  passed  in  the 
constructor. 

Piped  Streams: 

Provide  methods  for  allowing  two  threads  or  programs  to  send  data  between  them  in  a  reliable 
manner.  A  PipedlnputStream  must  be  connected  to  a  PipedOutputStream  and  vice  versa. 

Review 

•  File  Objects:  provides  handle  to  a  physical  file  and  returns  properties  of  files. 

•  FilenameFilter:  boolean  accept  method,  matches  file  properties  or  names. 

•  InputS treams:  basic  methods  for  read,  skip,  mark,  etc  bytes  of  data. 

•  OutputStream:  returns  void,  write,  flush,  and  close  methods. 

•  FileStreams:  uses  File  object  to  read  and  write  data  to  files 

•  Filered  streams:  process  the  data  as  its  being  read  or  written. 

•  PrintStream:  to  standard  output,  uses  print  or  println 

•  DataStreams:  primitive  types,  platform  independant  binary. 

•  Buffered  Streams:  increase  efficiency. 

•  SequencelnputStream:  connects  multiple  input  streams  sequentially. 

From  Nutshell  p.  131:FileCopy.java 

FilelnputStream 

This  InputStream  subclass  is  used  to  attach  a  "handle"  to  a  physical  sytem  file  for  reading.  It  provides  a 
low-level  interface  and  is  usually  used  with  a  Datainputstream  to  provide  a  higher-level  interface  for 
reading  data  and  text.  The  public  constructor  can  take  a  filename,  File  object  or  FileDescriptor 
object. 

(This  is  from  Nutshell  p.  126) 
Sample:  Fileviewer.java 

FileOutputStream 

This  InputStream  subclass  is  used  to  attach  a  "handle"  to  a  physical  sytem  file  for  reading.  The  public 
constructor  can  take  a  filename,  File  object  or  FileDescriptor  object.  If  the  file  does  not  already 
exist,  it  will  be  created. 
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Streams  Overview 


A  stream  is  an  abstract  concept  that  refers  to  the  movement  of  data  from  one  point  to  another.  We 
typically  think  of  this  data  as  a  sequence  of  bytes  which  we  can  either  read  or  write.  The  bytes  are 
frequently  read  from  or  written  to  a  file,  but  other  devices  such  as  network  connections  or  memory 
blocks  are  handled  in  essentially  the  same  way. 

Two  basic  abstract  types: 
InputStream  and  OutputStream 

InputStream  is  the  superclass  of  all  input  streams.  These  methods  will  throw  an  iOException  on  error. 
An  input  stream  is  automatically  opened  when  you  create  it.  Each  subclass  has 

•  read  ( )   reads  the  next  byte  of  data  on  the  stream. 

•  read  (byte  b  [  ] )   reads  into  an  array  of  bytes,  returns  number  read. 

•  read  (byte  b[],   int  off,   int  len)  starts  at  offset,  reads  into  an  array, 
all  read  ( )  methods  return  -1  at  the  end  of  the  stream. 

•  skip   (long  n)  skips  n  bytes  and  returns  actual  number  skipped. 

•  available  ( )  returns  number  of  bytes  available  without  blocking.(threads) 

•  close  ( )  closes  the  stream  and  frees  resources. 

•  markSupported  ( )  returns  true  if  supported. 

•  mark   (int  readlimit)  marks  current  position  in  the  stream. 

•  reset  ( )  returns  stream  pointer  to  lastmarkposition. 

OutputStream  provides  the  basic  output  methods  for  all  subclasses.  An  output  stream  is  automatically 
opened  when  you  create  it.These  methods  all  return  void  and  throw  IOException  on  error. 

•  write  ( int  b)  writes  a  single  byte  to  the  stream. 

•  write  (byte  b  [  ] )  writes  an  entire  array  of  bytes  to  the  stream. 

•  write  (byte  b[],    int  off,    int  len)  writes  a  subarray  to  the  output  stream. 

•  close  ( )  closes  the  output  stream. 

•  flush  ( )  clears  the  output  stream. 

Beneath  these  abstract  classes  are  more  refined  stream  types: 

•  File  Streams 

•  Filtered  Streams: 

O  Print  Streams 
O  Data  Streams 
O  Buffered  Streams 

•  SequencelnputStream 

•  RandomAccessFile 


•  Piped  Streams 

File  Streams: 

The  FilelnputStream  and  FileOutputStream  classes  are  used  to  read  and  write  data  to  actual  files  in 
a  host  system. 

FilterlnputStream  and  FilterOutputStream  are  subclasses  of  InputStream  and  OutputStream, 
respectively,  and  are  both  themselves  abstract  classes.  These  classes  define  the  interface  for  filtered 
streams.  Filtered  streams  process  the  data  as  its  being  read  or  written. 

Print  Streams: 

Extends  FilterOutputStream  to  print  textual  representations  of  all  primitve  data  types.  Uses 
print  ( )  and  print  in  ( )  to  output  the  text.  Print  in  ( )  follows  the  text  with  a  newline.  An  object 
is  converted  with  its  tostring  method  before  printing.  This  method  is  used  by  the  system,  out 
variable.  Note  that  this  class  may  not  print  all  Unicode  characters 

Data  Streams: 

Used  to  read  and  write  many  primitive  Java  types  from  or  to  the  respective  stream  in  platform 
independent  binary  format.  DataOutputStream  does  not  handle  Strings.  Example  of  keyboard 
echo. 

Buffered  Streams: 

Provide  data  buffering  to  increase  efficiency.  When  writing  data  to  a  physical  device  or  memory 
block,  multiple  accesses  may  take  longer  than  waiting  for  the  buffer  to  fill,  then  going  to  the  disk. 
The  size  of  the  buffer  may  be  specified,  else  it  defaults  to  32  bytes.  By  setting  up  a  such  an  input 
stream,  an  application  can  read  bytes  from  a  stream  without  necessarily  causing  a  call  to  the 
underlying  system  for  each  byte  read.  The  data  is  read  by  blocks  into  a  buffer;  subsequent  reads 
can  access  the  data  directly  from  the  buffer. 

Example  of  code  using  streams: 

FilelnputStream  in  =  null; 
DatalnputStream  dataln  =  null; 
Buf feredlnputStream  bis  =  null; 

in  =  new  FileInputStream(args [1] ) ; 
bis  =  new  Buf feredlnputStream (in) ; 
dataln  -   new  DatalnputStream (bis) ; 

OR 

DatalnputStream  dataln   = 
new  DatalnputStream (new  Buf feredlnputStream (new  FilelnputStream (args [1] ) ) ) ; 

SequencelnputStream 

Creates  a  single  input  stream  on  multiple  input  sources.This  example  concatenates  two  files  to  the 
console:  Concatenate  .Java  uses  ListOfFiles.java. 

RandomAccessFile: 

Though  not  a  stream  at  all,  this  class  implements  Datalnput  and  DataOutput  and  allows  the  reading 


and  writing  of  any  mixture  of  datatypes  to  any  location  in  a  file.  This  object  has  a  mode  associate 
with  it,  either  "r"  or  "rw"  for  read  only  or  read-write.  A  physical  filename  or  object  is  passed  in  the 
constructor. 

Piped  Streams: 

Provide  methods  for  allowing  two  threads  or  programs  to  send  data  between  them  in  a  reliable 
manner.  A  PipedlnputStream  must  be  connected  to  a  PipedOutputStream  and  vice  versa. 

Review 

•  File  Objects:  provides  handle  to  a  physical  file  and  returns  properties  of  files. 

•  FilenameFilter:  boolean  accept  method,  matches  file  properties  or  names. 

•  InputStreams:  basic  methods  for  read,  skip,  mark,  etc  bytes  of  data. 

•  OutputStream:  returns  void,  write,  flush,  and  close  methods. 

•  FileStreams:  uses  File  object  to  read  and  write  data  to  files 

•  Filered  streams:  process  the  data  as  its  being  read  or  written. 

•  PrintStream:  to  standard  output,  uses  print  or  println 

•  DataStreams:  primitive  types,  platform  independant  binary. 

•  Buffered  Streams:  increase  efficiency. 

•  SequencelnputStream:  connects  multiple  input  streams  sequentially. 

From  Nutshell  p.  131:FileCopy.java 

FilelnputStream 

This  InputStream  subclass  is  used  to  attach  a  "handle"  to  a  physical  sytem  file  for  reading.  It  provides  a 
low-level  interface  and  is  usually  used  with  a  Datainputstream  to  provide  a  higher-level  interface  for 
reading  data  and  text.  The  public  constructor  can  take  a  filename,  File  object  or  FileDescriptor 
object. 

(This  is  from  Nutshell  p.  126) 
Sample:  File  vie  wer.java 

FileOutputStream 

This  InputStream  subclass  is  used  to  attach  a  "handle"  to  a  physical  sytem  file  for  reading.  The  public 
constructor  can  take  a  filename,  File  object  or  FileDescriptor  object.  If  the  file  does  not  already 
exist,  it  will  be  created. 
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Applications 

We  have  already  discussed  how  the  main  ( )  method  works  and  is  required  for  starting  applications  that 
typically  run  from  the  command  line  with  the  Java  interpreter.  To  this  point,  our  graphical  applets  have 
run  in  either  in  the  appletviewer  or  on  web  pages  in  a  browser.  As  we  begin  to  explore  the  AWT,  we 
will  also  see  programs,  not  applets,  that  have  a  graphical  interface  yet  are  invoked  with  the  Java 
interpreter  and  run  without  the  aid  of  a  viewer. 

Example:Win_Clock.java  Seen  here  as  an  Applet. 

Applets 

We  have  previously  covered  how  to  embed  applets  in  web  pages  with  the  <appiet>  and  <param>  tags 
(HW1).  Now  we  will  look  at  the  pieces  that  make  the  applets  work. 

Every  serious  applet  uses  these  four  methods  found  in  the  java .  applet  .Applet  class:  init  ( ) , 
start  ( ) ,   stop  ( ) ,   destroy  ( ) .  The  Applet  class  has  these  default  methods  in  place,  however  they  are 
empty  so  it  is  common  to  override  them  to  enhance  their  functionality. 

init 

This  method  is  used  for  whatever  initializations  are  needed  in  your  applet.  It  works  much  like  a 
constructor  since  it  is  automatically  called  by  the  system  when  Java  launches  the  applet  for  the  first  time. 
Common  things  to  do  in  the  init  include  initailizing  variables,  getting  items  passed  via  the  <param> 
values  and  building  the  user-interface  components. 

Lets  look  at  the  ColorScribble  init  method. 

start 

This  is  the  second  method  automatically  called  after  init  and  is  also  called  whenever  a  stop  has  been 
called  or  the  user  has  left  the  page  and  then  later  returned  to  it.  This  is  where  the  work  gets  done.  It  is 
here  that  you  would  start  a  thread  of  execution.  Therefore,  if  it  only  has  to  run  once,  put  it  in  the  init, 
otherwise  it  goes  in  start.  If  you  are  not  doing  anything  that  needs  to  be  suspended,  this  method  and 
the  stop  method  do  not  need  to  be  implemented. 

stop 

Stops  the  applet  from  executing.  This  method  is  called  automaticaly  when  the  user  leaves  the  page 
where  the  applet  resides.  It  can  also  be  used  to  suspend  threads  that  don't  need  to  be  running  when  the 
applet  is  not  visible  or  to  stop  a  resource  consuming  activity  that  may  be  slowing  the  system  down.  You 
usually  will  not  need  to  call  this  method  directlyc  unless  you  are  performing  heavy  calculations  or 
running  audio  or  animations. 


destroy 

Frees  up  any  system  resources  that  the  applet  is  holding.  If  the  applet  is  running  in  a  browser,  the 
browser  will  determine  when  to  call  destroy.  Java  is  guaranteed  to  call  this  method  when  the  browser 
shuts  down  normally. 

Two  other  methods  that  show  up  frequently  in  graphical  applets  are  paint  and  update. 

paint 

This  method  will  run  anytime  the  applet  is  damaged,  usually  as  a  result  of  other  system  windows, 
pop-up  dialog  boxes  or  resizing  of  the  applet  window.  It  gets  called  frequently. 

update 

Each  time  the  window  needs  to  be  redrawn,  for  whatever  reason,  the  eventhandler  calls  its  update 
function.  The  default  implementation  for  update,  defined  in  Component,  is  to  erase  the  background  and 
call  paint.  To  avoid  a  flash  when  repainting,,  the  update  method  may  be  overridden. (Some  authors 
prefer  to  override  paint  instead.) 

A  Demo  by  Gordon  Bradley  that  illustrates  how  these  all  relate. 

A  word  about  System.  getProperty  ( )  p.324,  194 
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Applets  and  Applications 


Events 

Building  graphical  intefaces  with  buttons,  shapes,  lines,  menus  and  checkboxes  is  a  fairly  simple  task. 
The  functionality  of  any  applet  can  only  be  realized  by  incorporating  event  handlers  for  the  objects  in 
use.  The  event  type  values  are  defined  by  the  java .  awt .  Event  class  and  are  stored  in  the  id  field  of  the 

Event   Object. 

GUIs  and  Windowing  systems  use  event-driven  models  rather  than  procedural-  grab-  the-  input- 
yourself  models.  The  O/S  polls  constantly  for  events.  When  an  event  is  located,  it  is  relayed  to  the 
program  and  the  program  decides  how  to  handle  that  event. 

An  Event  object  is  created  anytime  a  user  does  something,  like  clicking  a  button  or  pressing  a  key,  on  a 

Component.  The  Component   deliver  Event  ( )    method  takes  the  Event   object  from  the  top  most 

component,  like  the  browser  or  a  window,  and  sends  it  down  to  the  lowest  component,  like  a  button. 

Once  the  target  component  is  reached,  the  AWT  allows  each  component  to  handle  the  event  at  every 
step  of  the  Component  hierarchy.  At  each  component  level,  the  Event  handler  may  modify  the  Event 
instance  before  it  is  passed  up,  stop  the  Event  from  being  processed  further  or  react  in  some  other  way 
by  doing  interim  processing. 

Each  Event  object  includes  the  following  information: 

1 .  The  type  of  the  event(a  key  press  or  mouse  click). 

2.  The  object  that  was  the  "target"  of  the  event(the  Button  clicked). 

3.  A  timestamp  indicating  when  the  event  occurred. 

4.  The  location  (x,y)  where  the  event  occurred. 

5.  The  key  that  was  pressed  (for  keyboard  events). 

6.  An  arbitrary  argument  (such  as  the  string  displayed  on  the  Component) 

7.  The  state  of  the  modifier  keys  when  the  event  occurred. 

Unhandled  events  are  passed  to  the  parent  container  via  postEvent  ( )   so  they  get  a  chance  to  deal  with 
the  event,  components  can  respond  to  events  by  implementing  a  custom  written  handieEvent()  method 
or  by  using  the  default  (component)  definition  of  handleEvent()  which  simply  calls  a  method  that's 
specific  to  the  event  type. 

Events  that  routinely  need  to  be  handled. 

(1)  ACTION_EVENT  -  Occurs  when  you  press  a  button,  select  a  menu,  etc. 

(2)  KEY_ACTION  -  Occurs  when  text  field  action  occurs. 

(3)  MOUSE_DOWN  -  Occurs  when  the  mouse  button  is  clicked  down. 

(4)  WINDOW_DESTROY  -  Occurs  when  the  window  of  the  object  is  closed. 


A  sample: 

class  ClosableFrame  extends  Frame 
{ 

public  ClosableFrame (String  t) 

{ 

super ( t ) ; 

} 

public  boolean  handleEvent (Event  e) 
{ 

if  (e.id  ==  Event . WINDOW_DESTROY )  System. exit ( 0 ) ; 
return  super . handleEvent ( e ) ; 
} 
} 

A  full  listing  of  the  Event  types  is  listed  on  p.  183-185  of  Nutshell 

Now  how  does  it  work?  Some  Examples  please! 

Look  at  the  EventTester  on  p90  of  Nutshell. 

Notice  the  init  ( )  method  and  the  get  Parameter  ( )  method  of  ColorScribble  p.  92 

If  you  want  to  have  really  easy  to  use  interfaces,  combine  mouse  events  with  keyboard  events  so  that, 
for  example,  a  user  can  either  click  on  a  button  or  tab  to  get  the  forcus  then  press  enter,  (find  example). 
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Components  and  Containers 


Component 


Subcomponents 


Figure  2  Structure  of  AWT 
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This  abstract  class  contains  the  basic  methods  that  all  its  subclassed  components  can  use.  Components 
are  the  window  icons  with  which  the  user  interacts  -  Buttons,  TextAreas,  Scrollbars,  etc.  Basically, 
Components  are  the  visible  GUI  controls  added  to  a  Container.  Anything  derived  from  the 

j  ava .  awt .  Component   class  can  be  a  Component.  (Nutshell  p.244) 

Some  common  methods  used  in  the  j  ava .  awt .  component  package  are: 

•  getBackground( ) 

•  setBackground (Color) 

•  getFont ( ) 

•  setFont (Font) 

•  mouseDown (Event ,  int,  int) 

•  show  ( ) 

•  resize(int,  int) 

•  paint (Graphics) 

•  update (Graphics) 


•  move ( int ,    int ) 

Containers 

The  container  class  is  an  abstract  subclass  of  Component  and,  is  designed  to  group  together  related 
components.  A  Container  may  also  contain  other  components.  The  two  subclasses  are  windows, 
which  provide  the  windows  to  contain  Components,  and  Panels,  which  group  Components  within  the 
area  of  an  exiting  window.  In  general,  components  must  be  added  to  a  Container  before  they  can  be 
used  or  modified.  They  use  the  add()  method  with  one  or  two  arguments  depending  on  the 
LayoutManager  used.  Common  methods  used  in  Containers  are: 

add ( Component ) ; 
add (String,  Component) ; 
remove ( Component ) ; 
getComponents ( ) ; 
setLayout (LayoutManager ) ; 
getLayout ( ) ; 

Windows 

When  an  application  is  written  for  a  GUI  using  the  AWT,  the  Window  class  provides  the  framework  for 
a  basic  standalone  process.  The  Window  is  the  next  major  subclass  of  Container  that  provides  a  top  level 
window  with  no  borders  or  menu  bar.  Although  it  is  rarely  called  directly,  it  does  provide  the  important 

event  handles  window_destroy,  window_iconify,  windowjdeiconify  and  window_move.  The 
two  Window  subclasses  are  Frame  and  Dialog. 

Frame 

The  Frame  subclass  of  window  provides  a  container  for  all  associated  components  used  in  the  main 
window  of  the  program.  The  Frame  has  many  predefined  convenience  methods  and  may  have  a 
specified  title,  menu  bar,  icon  and  cursor.  The  Frame  does  not  need  to  be  displayed  physically  within 
any  other  type  of  container  or  component,  it  can  stand  freely  on  its  own.  The  show()  and  hide()  methods 
make  the  Frame  appear  and  disappear  when  needed.  The  setResizable  (boolean)   determines  whether 
the  user  can  resize  the  Frame.  Frame  is  the  only  container  class  supporting  the  MenuComponents  class 
and  subclasses. 

The  MenuComponent  class  is  extended  from  the  object  class,  so  it  is  not  a  component  that  can  be 
usable  anywhere  or  instantiated  directly.  The  subclasses  using  MenuComponent  are  MenuBar ,  Menu, 
Menuitem  and  checkboxMenuitem.  The  MenuBar  sets  up  the  platform-dependent  group  of  menus, 
typically  across  the  top  of  the  window.  Each  menu  and  the  drop-down  list  of  options  is  represented  by  a 
Menu  object.  Each  object  on  the  list  is  a  Menuitem.  Menu  is  implemented  as  a  subclass  of  Menuitem,  so 
sub-menus  can  be  made  by  adding  one  menu  to  another.  For  example,  checkboxMenuitem  is  a  subclass 

of  Menuitem  class. 

Dialog 

The  Dialog  class  provides  a  simple,  encapsulated  dialog  box  which  blocks  further  user  input  until 
dismissed.  Dialogs  are  dependent  on  other  windows.  If  the  parent  window  is  iconified  or  destroyed,  the 


Dialog  box  goes  with  it.  A  handy  subclass  of  Dialog  is  the  FileDialog  which  brings  up  the  native 
file  chooser  window  to  allow  local  file  selection.  FileDialog  currently  has  Load  and  Save  buttons  built 
in,  but  other  operations  can  also  be  supported. 

Dialog (Frame   parent,    boolean  modal)      no   title   on  window. 
Dialog (Frame  parent,    String   title,    boolean  modal) 
FileDialog (Frame  parent,    String  title) 

Index 
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Subcomponents 

Subcomponents  and  their  constructors  are  added  using  the  add  ( Component )  or  additem(  string) 
method  and  removed  with  remove  ( ) .  Adding  a  component  doesn't  necessarily  create  the  native 
Subcomponent  (peer  Subcomponent)  for  that  component,  but  simply  inserts  the  component  into  the 
component  hierarchy.  The  native  Subcomponent  only  gets  instantiated  when  pack  ( )  or  show( )   is 
called  on  a  window  else  when  you  add  a  component  to  a  container  whose  native  subcomponent  is 
already  created.  The  Subcomponents  provide  basic  controls,  labels,  and  methods  for  creating  custom 
components  for  all  types  of  GUI  interfaces.  Many  trigger  ACTION_EVENTs  for  interactive 
applications. 

The  Button  creates  a  simple  on-screen  button  the  user  can  push.  A  string  within  the  constructor  shows 
up  as  a  label  on  the  button. 

Button ( ) ; 
Button (String) ; 

The  Canvas  provides  a  semantic-free,  nearly  abstract  class  which  inherits  its  functionality  from  the 
component  class.  The  Canvas  is  well  suited  for  building  custom  components.  It  is  ready  for  use  as  a 
drawing  surface  and  allows  the  implementation  of  event  handling.  When  the  canvas  is  extended, 
inherited  methods  are  overwritten  to  provide  the  desired  functionality. 

The  checkbox  has  a  selected/deselected  toggle  control  and  may  also  have  a  label.  It  may  be  initialized 
with  either  true  or  false  boolean  value.  A  series  of  checkboxes  in  the  same  checkboxGroup  will  be 
mutually  exclusive. 

Checkbox ( ) ; 

Checkbox (String) ; 

Checkbox (String,  CheckboxGroup,  Boolean); 

The  choice  creates  a  pop-up  menu  on  the  screen  when  the  user  clicks  on  it.  Items  are  listed  in  the  order 
added  to  the  class  with  addltem.  Only  the  first  item  added  will  be  displayed  on  top. 

Choice  C  =  new  Choice ( ) ; 
C . addltem ( "First  choice"); 

The  Label  displays  a  static  line  of  text,  although  it  may  be  constructed  empty  and  set  at  a  later  time. 
Labels  also  have  an  alignment  property  of  LEFT,  CENTER  or  RIGHT  stored  as  an  integer. 

Label ( ) ; 
Label (String) ; 
Label (String,  int) ; 

The  List  displays  a  scrolling  list  of  items  of  which  one  or  many  may  be  selected.  A  List  can  specify  the 
number  of  lines  to  be  visible  or  use  the  size  of  the  container  as  the  default.  A  boolean  is  set  to  determine 


if  multiple  selections  are  permitted. 

List      itemlist      =   new  Listd,    true); 
itemlist .addltem( "first   item") ; 
itemlist .addl tern ( "second   item") ; 

The  scrollbar  displays  the  familiar  windows  control  for  moving  through  a  range  of  values.  The 
orientation  is  set  to  HORIZONTAL  or  VERTICAL.  The  initial  value  or  position  of  the  thumb  is  set  to 
an  integer  value.  The  visibility  or  overall  area  displayed  is  specified  in  pixels.  The  minimum  and 
maximum  size  of  the  scrollable  area  are  also  specified  in  pixels  as  integers. 

Scrollbar (orientation) ; 

Scrollbar (orientation  int,  initial_value  int,  visible 
int,  minimum  int,  maximum  int) ; 

The  Textcomponent  superclass  of  TextArea  andTextFieid  supplies  many  methods  which  allow  the 
programmer  to  set  the  text  editable  or  not,  get  the  text  after  user  input  and  select  text  between  beginning 
and  end  positions  the  programmer  specifies.  The  TextField  creates  field  with  a  single,  editable  line  of 
text.  The  number  of  columns  in  the  text  field  may  be  set  with  an  integer,  and  the  text  initially  displayed 
is  set  with  a  String.  TextField  also  has  the  useful  setEchoChar()  method  which  is  useful  for  password 
fields. 

TextField ( ) ; 
TextField (int) ; 
TextField (String) ; 
TextField (String,  int) ; 

TextArea  creates  a  multi-line  box  for  text  entry.  The  TextArea  may  be  any  height  and  width- 
scrollbars  are  added  by  default.  The  int  arguments  set  the  number  of  rows  and  columns  (respectively)  of 
the  area.  The  appendText()  method  allows  text  to  be  added  to  the  TextArea  incrementally.  Other 

methods  include  insertText  ( String ,    int )  and  replaceText  ( String ,    int ,    int ) .  Like  the 
TextField  class,  TextArea   has  four  constructors. 

TextArea ( ) ; 
TextArea ( int ,  int); 
TextArea (String) ; 
TextArea (String,  int,  int); 
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Panels  and  Layout  Managers 

Panel 

A  Panel  is  one  of  the  most  generic,  yet  concrete,  containers  available  which  can  be  displayed  on- 
screen. Once  a  component  is  added  to  a  Panel,  it  can  be  manipulated  using  the  move  ( ) ,   resize  ( )   or 
reshape  ( )   methods  inherited  from  component.  Each  Panel  or  sub-panel  may  be  treated  as  a 
Container  in  its  own  right.  To  offer  more  control  and  flexibility  in  how  components  are  displayed 
within  a  container,  the  abstract  class  LayoutManager  is  used.  The  final  appearance  of  a  component  is 
determined  by  which  LayoutManager  is  used,  and  the  order  in  which  items  are  added  to  the  container. 

Layout  Managers 

Layouts  define  how  Components  are  "laid  out"  within  a  Container.  There  are  five  predefined  subclasses 
of  the  LayoutManager.  Since  the  LayoutManager  class  is  abstract,  it  cannot  be  used  directly.  Instead,  it 
must  be  a  sub-class  with  its  own  functionality  or,  use  a  derived  class  defined  in  the  AWT  -  i.e. 
BorderLayout,  CardLayout,  GridLayout,  FlowLayout,  etc.  The  actual  appearance  of  the  AWT 
components  on-screen  is  determined  by  the  order  in  which  they  are  added  to  the  Panel,  (and  the 
LayoutManager  class  the  panel  is  currently  using  to  lay  out  the  screen.)  The  LayoutManager  class 
determines  how  portions  of  the  screen  are  sectioned  and  how  components  within  the  Panel  are  placed. 
Layouts  at  Sun. 

The  BorderLayout  arranges  components  around  the  edges  of  the  container  according  to  an  area 
specified  in  the  instantiation  of  the  component.  The  areas  of  choice  are:  north,  south,  east,  west,  and 
center.  The  area  in  which  components  are  added  is  important.  If  a  center  component  is  added  it  gets 
allocated  all  remaining  space.  The  other  areas  expand  only  as  much  as  necessary  to  keep  all  available 
space  filled.  The  argument  add()  method  is  used  to  add  a  component  with  BorderLayout.  If  a  gap  is 
desired  between  components,  the  horizontal  and  vertical  pixel  values  are  set  with  the  setLayout  method. 
BorderLayout  is  the  default  layout  manager  for  all  Windows,  such  as  Frames  and  Dialogs. 

Add( "direction" ,  new  Component ( "string" ) ) ; 
BorderLayout (int  horizontalGap,  int  verticalGap) ; 

The  CardLayout  gets  its  name  because  only  one  visible  display  space  is  visible  although  many 
Containers  may  use  the  same  space.  Like  a  stack  of  playing  "cards",  components  may  be  displayed  by 
calling  the  methods  first(),  last(),  next(),  previous(),  or  show()  to  get  a  specific  card.  Again,  the  argument 
add(String  name,  Component  comp)  is  required  with  the  String  being  an  identifier  for  that  component. 
The  order  in  which  components  are  added  determines  their  order  in  the  "deck". 

Panel  cardl  =  new  Panel ( ) ; 

cardl . setLayout (new  CardLayout ( ) ) ; 

add(" first",  cardl); 

cardl . show (cardl, "first" )  ; 


The  GridLayout  provides  an  easy  method  for  organizing  components  in  a  grid.  All  components  are 
placed  in  equally  sized  cells,  and  placed  in  the  container  in  the  order  in  which  they  are  added,  starting  in 
the  top  row  from  left  to  right.  If  a  window  containing  a  GridLayout  is  resized,  the  cells  grow  or  shrink  so 
that  all  the  space  available  to  the  container  is  used.  The  GridLayout  constructor  includes  the  number  of 
rows  and  columns  required.  As  an  option,  horizontal  and  vertical  gaps  maybe  specified  in  pixels.  At 
least  one  of  the  row  arguments  or  column  arguments  must  be  non-zero. 

GridLayout ( int    rows,    int   columns); 
GridLayout (int   rows,    int   columns,    int  horizontalGap,    int  verticalGap); 

The  GridBagLayout  is  much  more  flexible  than  GridLayout  as  it  allows  specific  components  to  span 
multiple  rows  or  columns.  The  characteristics  of  each  component  is  optionally  set  with 
GridBagConstraints.  Various  options  may  be  set  including  anchor  position;  grid  position,  which  may  be 
relative  or  absolute;  the  number  of  horizontal  and  vertical  cells  occupied;  fill  direction;  margin  insets; 
and  directional  weights. 

GridBagLayout ( ) ; 

Sun's  GridBagConstraints  lesson. 

The  FlowLayout  is  probably  the  simplest  to  use.  Its  puts  components  in  a  row  until  the  horizontal  space 
is  full,  then  shifts  to  multiple  lines.  Horizontal  and  vertical  gaps  may  be  specified  with  a  default  of  five 
pixels.  The  alignment  of  the  components  on  the  rows  may  be  LEFT,  RIGHT,  or  CENTER  justified 
when  the  FlowLayout  is  created.  FlowLayout  is  the  default  layout  manager  for  all  Panels. 

FlowLayout ( )  ; 

FlowLayout (int  alignment); 

FlowLayout (int  alignment,  int  horizontalGap,  int  verticalGap); 

A  great  set  of  examples  from  Sun. 
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Networking 

java .net  supports  both  TCP/IP  and  UDP  protocol  families. 

TCP/IP  is  used  for  reliable  stream-based  communication  across  the  Internet.  It  specifies  the  manner  in 
which  two  processes  running  on  different  machines  on  the  Internet  find  each  other,  rendezvous,  and 
transfer  data.  It  also  makes  sure  data  are  transferred  in  the  correct  sequence  and  without  error. 

UDP  (Unreliable  Datagram  Protocol)  is  used  for  unreliable  datagram  communication;  also  called 
"fire-and-forget"  packet  transmission  across  the  network. 

TCP/IP  uses  a  static  addessing  scheme—every  machine  on  the  Internet  is  assigned  a  unique,  fixed  IP 
address. 

IP  Addresses 

IP  addresses  are  32-bit  numbers  usually  written  as  four  8-bit  numbers  separated  by  dots. 

For  example,  18.157.0.135  and  127.1.18.92. 

IP  addresses  are  organized  in  a  hierarchical  way  into  a  series  of  networks  and  subnets.  The  Network 
Information  Center  (NIC)  allocates  blocks  of  contiguous  addresses  to  organizations  and  regional 
networks. 

A  small  organization  might  receive  the  block  of  255  addresses  from  192.66.12.1  to  192.66.12.255  (this 
is  called  a  class  "C"  address). 

A  large  organization,  such  as  a  university,  might  receive  the  block  of  approximately  65,000  addresses 
from  128.15.0.1  to  128.15.255.255  (this  is  called  a  class  "B"  address). 

Even  larger  entities,  such  as  the  military  or  a  regional  net,  might  be  granted  one  or  more  class  "A" 
addresses,  such  as  the  block  18.0.0.1  to  18.255.255.255,  encompassing  more  than  16  million  addresses. 

Longer  addresses  will  replace  the  current  ones  over  the  next  few  years. 
Networks  and  Hosts 

Class  Address  Network  Part  Host  Part 

A  18.155.32.5  18.  155.32.5 

B  128.15.32.5  128.15  32.5 

C  192.66.12.56  192.66.12  56 

Raw  IP  addresses  are  assigned  names  using  a  distributed,  hierarchical  lookup  system  called  the  Domain 
Name  System  (DNS).  In  DNS,  each  machine  has  a  unique  name  consisting  of  multiple  parts  separated 
by  dots.  The  first  part  is  the  machine's  host  name,  followed  by  a  list  of  domains. 


The  first  domain  is  usually  an  identifier  for  the  organization  to  which  the  machine  belongs,  followed  by 
more  subtitles,  and  concluding  with  a  label  for  the  top-level  domain.  In  the  U.S.,  the  top-level  domain  is 
usually  edu  (educational),  com  (commerce),  mil  (military),  net  (network  providers),  and  org  (other 
organizations). 

For  the  rest  of  the  world,  the  top-level  domain  usually  identifies  the  country:  jp  (Japan),  de  (Germany  or 
Deutschland),  and  so  on. 

The  dots  in  domain  names  have  no  correspondence  to  the  dots  in  IP  addresses.  Domain  names  may  have 
two,  three,  or  more,  depending  on  how  the  local  naming  system  is  set  up.  For  example, 

gold.cs .nps .navy.mil 

has  five  parts.  The  top-level  domain  is  mil  for  military. 

The  information  in  the  DNS  system  is  distributed  among  a  large  number  of  DNS  databases  called 
domain  name  servers,  each  maintained  by  the  organization  responsible  for  its  piece  of  the  network.  The 
DNS  databases  are  just  human-readable  tables  associating  numeric  IP  addresses  with  host  names. 

When  a  program,  like  a  browser  or  rlogin,  is  given  a  domain  name  to  connect  to,  it  first  queries  its 
local  domain  name  server  (in  the  CS  dept,  it  is  machine  taurus)  to  find  the  numeric  IP  address  for  the 
name.  If  the  server  doesn't  know,  which  is  often  the  case,  it  queries  another  name  server  closer  to  the 
destination,  and  that  server  may  in  turn  query  a  third,  and  so  on. 

Ports 

When  two  network  programs  wish  to  communicate,  it  is  not  enough  for  them  each  to  know  the  other's 
IP  address.  A  single  machine  may  be  running  multiple  programs  as  servers.  For  a  particular  program  to 
be  able  to  communicate  with  a  server,  the  program  needs  to  know  to  which  port  the  server  is 
"connected".  That  is,  to  which  port  is  the  server  "listening"?  Ports  are  soft  (operating  system  entities). 
On  UNIX  systems,  when  a  server  starts  up,  it  notifies  the  operating  system  of  the  port  it  will  listen  to. 

For  example,  a  typical  UNIX  machine  offers  TELNET  and  FTP  servers.  It  may  also  be  running  a  Web 
server  like  the  CERN  server  or  NCSA's  httpd.  On  UNIX  systems,  port  numbers  between  0  and  1024  are 
reserved,  by  convention,  for  particular  servers: 


Protocc 

>1 

Port 

date  server 

13 

FTP 

21 

Telnet 

23 

SMTP 

25 

Gopher 

70 

HTTP 

80 

Usenet 

news 

119 

WAIS 

210 

So  if  a  network  program  wishes  to  communicate  with  the  Web  server,  it  must  know  to  which  port  the 
server  is  connected. 


Networking  in  Java 

The  InetAddress  Class 

The  class  represents  an  Internet  address.  It  has  no  public  constructors,  just  three  class  methods  that 
create  instances  of  the  class: 

1.  InetAddress  getLocaIHost( )  throws  UnknownHostException; 

2.  InetAddress  getByName(String  host)  throws  UnknownHostException; 

3.  InetAddress []  getAIlByName(String  host)  throws  UnknownHostException; 

The  instance  methods  include: 

1.  byte[]  getAddress( ); 

2.  String  getHostName( ); 

getAddress( )  returns  the  IP  address  as  an  array  of  bytes  in  "network  byte  order";  getHostName( )  returns 
the  host  name  of  an  IP  address. 

See  InetDemo.java. 
Datagrams 

Datagram  communication  by  UDP  is  fast,  but  the  tradeoff  is  that 

1 .  the  protocol  makes  no  attempt  to  ensure  they  reach  their  destination  or  to  resend  them  if  they  did 
not 

2.  they  are  not  stream  based;  there  is  no  semi-permanent  connection 

3.  they  are  unidirectional 

To  send  and  receive  datagrams  in  Java,  use  the  DatagramPacket  and  DatagramSocket  classes. 

DatagramPacket 

The  DatagramPacket  class  has  two  constructors: 

1.  DatagramPacket(byte  [],  buf,  int  buflength); 

2.  DatagramPacket(byte  [],  buf,  int  buflength,  InetAddress  ipaddr,  int  port); 

The  first  constructor  is  used  to  receive  a  datagram  while  the  second  is  used  to  send  a  datagram. 
The  contents  and  sender  of  a  received  packet  may  be  queried  with  the  instance  methods: 

1.  InetAddress  getAddress( ); 

2.  byte[]  getData( ); 

3.  int  getLength( ); 


4.  int  getPort( ); 
Datagram  packets  are  sent  and  received  using  the  DatagramSocket  class. 

The  DatagramSocket  Class 

The  class  defines  a  socket  that  can  receive  and  send  unreliable  datagram  packets  over  the  network. 
The  class  has  two  constructors: 

1 .  DatagramSocket( )  throws  SocketException; 

2.  DatagramSocket(int  port)  throws  SocketException; 

The  first  constructor  is  used  to  create  a  datagram  socket  for  sending  a  packet  and  the  port  to  be  used  is 
chosen  by  the  system. 

The  second  constructor  creates  a  socket  for  sending  or  receiving  packets  using  the  instance  methods: 

1.  void  send(DatagramPacket  p)  throws  IOException; 

2.  void  receive(DatagramPacket  p)  throws  IOException; 

See  WriteServer.java  and  ReadClient.java. 

Sockets  for  Clients 

TCP/IP  sockets  are  used  to  implement  reliable  bi-directional,  stream-based  connections  between  a  server 
and  a  client  on  the  Internet. 

Java's  I/O  system  can  be  connected  to  a  server  so  that  streams  from  files  and  servers  are  treated 
uniformly. 

In  Java,  TCP/IP  sockets  are  created  via  the  class  Socket. 

The  Socket  Class 

The  Socket  class  has  four  constructors: 

1 .  Socket(String  host,  int  port)  throws  UnknownHostException,  IOException; 

2.  Socket(String  host,  int  port,  boolean  stream)  throws  IOException; 

3.  Socket(Inet Address  addr,  int  port)  throws  IOException; 

4.  Socket(InetAddress  addr,  int  port,  boolean  stream)  throws  IOException; 

You  may  optionally  specify  whether  communication  through  the  socket  should  be  based  on  a 
connection-based  stream  protocol  or  UDP. 

A  socket  can  be  examined  for  the  address  and  port  associated  with  it  using: 


1.  getInetAddress( )  returns  the  InetAddress  of  the  Socket  object. 

2.  getPort( )  returns  the  remote  port  of  the  Socket  object. 

3.  getLocalPort( )  returns  the  local  port  of  the  Socket  object. 

Unlike  datagram  sockets,  client  sockets  are  handled  using  stream-based  I/O  classes  in  Java,  just  as  files 
are  handled: 

1 .  getInputStream( )  returns  the  InputStream  of  the  Socket  object. 

2.  getOutputStream( )  returns  the  OutputStream  of  the  Socket  object. 

3.  close( )  closes  both  the  InputStream  and  OutputStream. 

See  the  following  examples: 

1.  Query Server.java 

2.  Query HTTP.java 

Sockets  for  Servers 

A  server  socket  "listens"  to  a  port  for  connection  requests  from  clients. 

When  a  connection  request  arrives,  a  ServerSocket  object  creates  a  new  Socket  object  for 
communication  with  the  client. 

ServerSocket  has  two  constructors: 

1.  ServerSocket(int  port)  throws  IOException; 

2.  ServerSocket(int  port,  int  count)  throws  IOException; 

The  first  creates  a  server  socket  on  the  specified  port.  The  second  creates  a  server  socket  on  the  specified 
port,  waiting  up  to  count  milliseconds  for  a  connection  request. 

ServerSocket  has  the  following  instance  methods: 

1.  Socket  accept(  )  throws  IOException;  blocks  until  a  connection  request  is  detected  from  a  client  at 
which  time  it  returns  a  new  Socket  object  for  communication  with  the  client. 

2.  InetAddress  getInetAddress( );  returns  the  InetAddress  of  the  client  issuing  the  connection 
request. 

3.  getLocalPort( );  returns  the  local  port  in  use  by  the  ServerSocket  object. 

See  the  following  examples: 

1.  EchoServer.java 

2.  EchoClient.java 

A  Multi-threaded  Server 

The  EchoServer  is  a  single-client  server.  It  cannot  service  multiple  clients  simultaneously. 


To  overcome  this  limitation,  we  make  the  server  threaded  and  call  it  ThreadedEchoServer.java. 
The  client,  EchoClient.java,  does  not  require  any  changes. 

Fetching  URLs  in  Java 

The  program  Query HTTP.java  connected  to  an  HTTP  server  of  a  specified  host  and  output  the  server's 
response  to  System.out. 

The  correct  way  to  communicate  with  an  HTTP  server  is  to  use  the  class  URL.  It  has  four  constructors, 
two  of  which  are 

1 .  URL(String  protocol,  String  host ,  int  port ,  String  file)  throws  MalformedURLException; 

2.  URL(String  protocol,  String  host,  String  file)  throws  MalformedURLException; 

The  instance  methods  of  the  class  include 

1.  URLConnection  openConnectionO  throws  IOException; 

2.  final  Inputstream  openStreamf)  throws  IOException; 

The  class  URLConnection  has  a  rich  set  of  methods  for  gaining  easy  access  to  information  used  by 
HTTP  such  as 

1.  getContentType();  returns,  for  example,  text/plain,  text/html  or  application/octet-stream 

2.  getContentLength(); 

See  page  336-337  of  Java  in  a  Nutshell  for  a  complete  description. 

We  use  openStream()  in  the  simple  example  FetchURLDemo.java  to  illustrate  fetching  a  URL. 

Java  and  CGI  Scripts 

The  interface  with  CGI  in  Java  is  primitive. 

See  CGIDemo.java  as  a  simple  example  of  a  Java  program  that  connects  to  an  HTTP  server  and  requests 
it  to  execute  a  perl  script  using  HTTP  GET. 
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Threads 

java .  lang  supports  light-weight  processes  called  threads  which  can  be  run  in  parallel. 

Threads  are  run  asynchronously  within  the  same  address  space  compared  to  heavy-weight  processes 
which  run  in  separate  address  spaces  and  traditionally  communicate  in  UNIX  environments  using 
sockets  and  pipes. 

With  threads,  interprocess  communication  and  context  switching  are  less  expensive,  providing  the 
operating  system  supports  threads. 

Solaris  2.x  and  Windows95/NT  support  threads  but  thread  scheduling  actually  varies  among  them;  as 
yet,  no  Java  semantics  exists  for  thread  scheduling  behavior. 

Threads  can  improve  the  performance  of  a  system.  For  example,  if  a  Java  program  needs  to  create  a 
socket  connection  and  create  the  widgets  of  a  GUI,  then  the  socket  can  be  created  using  a  thread  so  that 
if  the  connection  is  delayed,  GUI  construction  does  not  block. 

The  Thread  Class 

The  Thread  class  has  seven  constructors.  Among  them  are 

1.  Thread(Runnable  target); 

2.  Thread(Runnable  target,  String  name); 

The  Thread  class  (static)  methods  include 

1.  static  Thread  currentThread( );  returns  current  thread 

2.  static  void  sleep(long  milliseconds)  throws  InterruptedException;  makes  the  current  thread 
suspend  for  a  specified  amount  of  time 

See  CurrentThreadDemo.java. 
The  Runnable  Interface 

Each  of  the  preceding  Thread  constructors  takes  an  object  of  the  interface  Runnable: 

public  abstract  interface  Runnable  { 
public  abstract  void  run (  )  ; 
} 

Any  class  that  implements  Runnable  (i.e.  defines  method  run( ))  can  provide  the  body  of  a  thread.  See 
ThreadDemo  j  ava. 

Daemon  Threads 


When  does  a  concurrent  Java  program  terminate? 

When  the  only  threads  that  remain  are  daemon  threads.  A  daemon  thread  is  one  that  exists  only  to 
provide  a  service  to  other  threads. 

A  thread  is  asserted  to  be  a  daemon  thread  by  the  instance  method: 

final  void  setDaemon(boolean  on)  throws  HlegalThreadStateException; 

See  Timeslicer.java. 

Thread  Priorities 

Every  thread  has  a  priority. 

Thread  priorities  are  integers  in  the  range  1  to  10.  They  are  used  to  determine  which  thread  among  a 
collection  of  enabled  threads  should  be  scheduled  for  execution. 

A  thread  can  voluntarily  relinquish  control  by  explicitly  yielding,  sleeping,  or  blocking  on  pending 
I/O.  In  this  case,  all  threads  are  examined  and  the  highest-priority  thread  that  is  ready  to  run  resumes 
execution. 

A  thread  can  be  pre-empted  by  a  higher-priority  thread  that  is  ready  to  run. 

When  there  are  multiple  threads  of  the  same  priority,  they  should  EXPLICITLY  yield  control  to  their 
peers. 

Caution:  Currently  JDK  1 .0  for  Windows95/NT  will  time  slice  in  a  round-robin  fashion  among  threads 
of  the  same  priority  that  do  not  relinquish  control  voluntarily.  This  is  not  so  for  Solaris  2.x.  See  the 
example  HiLoPri.java. 

Explicit  time  slicing  is  implemented  by  the  class  Timeslicer.java. 

Thread  Synchronization 

Why  is  synchronization  important? 

A  necessary  condition  for  the  correctness  of  a  concurrent  program  consisting  of  multiple  threads  is 
serializability. 

Simply  put,  the  outcome  of  a  concurrent  execution  of  some  set  of  threads  should  be  reproducible  by  a 
serial  execution  of  them. 

If  the  threads  share  a  resource,  then  their  concurrent  execution  may  not  be  serializable. 

Consider  a  shared  bank  account  with  two  depositors.  Both  simultaneously  deposit  into  the  account.  The 


situation  is  simulated  in  BankDemo.java. 

The  program  in  Synch.java  also  demonstrates  a  concurrent  execution  that  is  not  serializable. 

Synchronized  Methods  in  Java 

Java  adopts  the  concept  of  a  monitor  introduced  by  Hoare.  Monitors  were  used  long  ago  in  Brinch 
Hansen's  concurrent  Pascal. 

But  monitors  are  incorporated  differently  in  Java. 

A  monitor  can  be  thought  of  as  a  form  of  encapsulation  with  a  mutual-exclusion  property.  The  idea  is 
that  a  process  may  call  a  method  of  the  encapsulation  after  it  has  gained  entry  to  the  monitor. 

At  most  one  process  can  be  "in"  the  monitor  at  any  time.  Following  completion  of  the  method,  the 
process  relinquishes  the  monitor  to  any  other  processes  that  may  be  waiting  for  it. 

In  Java,  a  monitor  is  an  instance  of  a  class  with  one  or  more  methods  of  the  class  declared  as 
synchronized. 

Once  a  thread  enters  a  synchronized  method  of  an  object,  no  other  thread  can  enter  any  synchronized 
method  of  that  object.  Non-synchronized  methods  can  still  be  called  however. 

For  example,  we  can  declare  the  deposit  method  in  BankDemo.java  to  be  synchronized  in  order  to  solve 
the  two-depositor  problem. 

Another  way  to  get  serializability  is  to  use  the  synchronized  statement. 

This  is  useful  when  you  are  using  a  class  that  was  not  designed  for  multi-thread  access  and  thus  has 
non-synchronized  methods  which  manipulate  internal  state. 

The  synchronized  statement  has  the  form 

synchronized(<9b/ec?)  statement; 

The  statement  is  usually  a  call  to  a  method  of  the  object.  The  method  call  then  will  be  handled  as  though 
the  method  had  actually  been  declared  synchronized. 

For  example  in  BankDemo.java,  we  can  convert  the  run  method  to 

public  void  run    (    )     { 

synchronized    (a)     { 

a .deposit (amt,    name,    delay); 

} 
} 

Inter-thread  Communication 

Why  is  thread  communication  in  Java? 


So  far  we  have  seen  the  need  for  mutually-exclusive  access  to  a  shared  resource  in  order  to  satisfy 
serializability. 

This  is  a  necessary  condition  for  the  correctness  of  a  concurrent  (threaded)  Java  program,  however,  it 
may  not  be  sufficient.  Correctness  may  depend  on  other  conditions  as  well. 

Consider  a  Producer  and  Consumer  as  simulated  in  PC.java  where  Ql.java  uses  synchronized  methods. 
Clearly  the  output  of  the  program  can  be  serialized. 

Notice  the  need  for  synchronized  get  and  put  methods.  If  we  use  Q2.java  instead,  where  the  methods  are 
no  longer  synchronized,  then  get  can  output  n's  value,  put  can  then  set  n  to  a  different  value  which  get 
would  then  return. 

Even  though  the  output  is  serializable,  it  is  unacceptable  if  there  is  an  additional  condition  that  the 
consumer  must  consume  every  value  produced  at  most  once.  So  suppose  we  take  this  additional 
condition  as  another  correctness  criterion. 

What  must  we  do  then  to  make  the  program  PC.java  correct  under  this  new  criterion? 

Livelock 

Consider  modifying  the  queue  of  PC.java  so  that  it  uses  busy  waiting  or  polling  as  in  Q3.java. 

The  problem  with  Q3.java  is  that  either  the  Producer  or  Consumer  may  busily  wait  once  inside  the 
monitor  which  means  that  if  it  should  be  pre-empted,  the  other  cannot  call  its  queue  method  to  break  the 
busy  wait.  So  the  computation  goes  back  into  a  busy-wait  state. 

Since  the  computation  proceeds,  but  no  progress  will  ever  be  made,  the  program  livelocks. 

The  solution  is  to  use  inter-thread  communication  via  Java's  wait( ),  notify( )  or  notify All( ). 

All  three  methods  can  only  be  called  from  inside  synchronized  methods. 

A  thread  can  enter  a  synchronized  method  of  an  object  and  wait  there  until  some  other  thread  notifies  it 
via  notify.  More  precisely,  we  have 

1.  final  void  wait( )  throws  InterruptedException,  IllegalMonitorStateException; 

forces  the  current  thread  to  relinquish  control  of  the  monitor  and  to  go  to  sleep  until  some  other 
thread  enters  the  same  monitor  and  calls  notify( )  or  notify All( ). 

2.  final  void  notify( )  throws  IllegalMonitorStateException; 
wake  up  the  first  thread  that  called  wait( )  on  the  same  object. 

3.  final  void  notifyAH( )  throws  IllegalMonitorStateException; 

wakes  up  all  threads  that  called  wait( )  on  the  same  object.  The  highest-priority  thread  awakened 
runs  first. 

Reminder.  Waiting  in  a  synchronized  method  relinquishes  control  of  the  monitor  so  that  multiple  threads 


can  enter  the  same  method  and  wait  for  the  same  notification. 

Finally,  a  solution  to  the  Producer-Consumer  problem  is  given  in  Q4.java. 

As  another  example  of  the  need  for  inter-thread  communication,  see 

1.  OneCarBridgeTest.java;  uses  only  synchronized  methods  to  coordinate  the  use  of  a  single-lane 
bridge  assuming  the  maximum  bridge  load  is  one  car. 

2.  BridgeTest.java;  uses  wait( )  and  notify All( )  to  coordinate  the  use  of  a  single-lane  bridge 
assuming  the  maximum  bridge  load  is  three  cars  [Smith]. 

Deadlock 

A  state  where  two  threads  have  a  circular  dependency  on  a  pair  of  synchronized  objects. 

See  Deadlock.java. 
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Applet  Security 


The  following  material  is  based  on  information  found  in  Exploring  Java,  Pat  Niemeyer  &  Joshua  Peck, 
O'Reilly. 

The  Java  security  model  has  three  primary  layers: 

1.  the  programming  language  design  layer 

2.  the  byte-code  verification/class  loader  layer 

3.  security  manager  layer 

The  programming  language  design  layer 

This  is  often  referred  to  as  implementation  safety. 

Though  not  clearly  defined,  it  is  intended  to  capture  protection  against  segmentation  faults  caused  by 
dereferencing  dangling  or  nonexistent  pointers,  or  invalid  address  arithmetic. 

It  also  is  intended  to  capture  protection  against  pointer  forging  as  in  C++ 

class  CreditCard  { 

private: 

char  creditCardNo [16] ; 
}; 
main (  )  { 

CreditCard  cc; 

//  forge  a  pointer  to  peek  inside  class 

char  *ccno  =  (char  *)cc; 

print f ( "%s\n" ,  ccno) ; 
} 

Java  doesn't  allow  class  types  to  be  coerced,  subverting  encapsulation.  Further,  Java  doesn't  allow 
pointer  arithmetic,  does  not  have  an  "address  of  operator,  and  has  automatic  memory  management 
(garbage  collection). 

Another  language-level  issue  is  final  classes  which  prevents  class  extension  of  classes  that  are  part  of 
the  system. 

Byte-code  verification  and  class  loading  layer 

Classes  that  are  loaded  from  over  the  network  are  subjected  to  byte-code  verification. 

Instructions  of  the  Java  virtual  machine  are  typed.  There  are  separate  instructions  for  stack  operations 
for  object  references  and  for  each  of  the  numeric  types  in  Java.  Further,  there  are  separate  move 
instructions  for  each  type  of  value. 


The  type  of  an  object  resulting  from  an  instruction  is  unique. 

All  this  means  that  byte  code  can  be  type  checked  to  ensure  that  instructions  are  used  in  ways  they  were 
intended  to  be  used. 

The  verifier  constructs  a  type  state  which  consists  of  the  types  of  class  variables  and  types  of  values  on 
the  stack.  It  ensures  that  instruction  types  and  stack  value  types  match. 

The  verifier  requires  that  all  execution  paths  to  the  same  point  in  the  code  arrive  with  the  same  type 
state,  which  means  the  same  number  of  elements  on  the  stack. 

This  rules  out  code  that  stacks  values  in  a  loop. 

Therefore,  if  the  code  passes  the  verifier,  we  know  what  its  stack  requirements  will  be  when  executed.  If 
the  verifier  finds  that  a  requirement  is  stack  underflow  or  stack  overflow  then  it  rejects  the  code. 

Security  manager  layer 

The  SecurityManager  is  responsible  for  making  application-level  security  decisions. 

A  security  manager  is  an  object  that  can  be  installed  by  an  application  to  restrict  access  to  system 
resources. 

It  is  consulted  every  time  an  application  tries  to  access 

1.  file  system 

2.  network  ports 

3.  system  properties 

An  instance  of  the  SecurityManager  class  can  be  installed  only  once  during  an  invocation  of  the  Java 
interpreter.  Thereafter,  every  access  to  a  system  resource  is  filtered  through  specific  methods  of  the 
SecurityManager  object  by  the  core  Java  packages.  Among  these  methods  are 

checkAccess (Thread  g)    Access    this   thread? 

checkRead( String   file)    Read  a    file? 

checkWrite (String   file)    Write   a    file? 

checkDelete (String   file)    Delete   a    file? 

checkConnect (Sring  host,    int  port)    Connect   a   socket   to   a  host? 

checkListen(int  port)    Create   a   ServerSocket? 

checkPropertyAccess (String  key)    Access   property  associated  with  key? 

checkTopLevelWindow( Object  window)    Create   this   top-level   window? 

All  these  methods  simply  return  to  grant  access  and  throw  a  SecurityException  otherwise  except  for 
checkTopLevelWindow( ),  which  returns  true  if  access  is  granted  and  false  if  not;  a  value  of  false 
indicates  the  access  is  granted  but  that  the  new  window  should  provide  a  warning  border  that  it  is 
untrusted. 

See  UntrustedWindow.java 


The  security  manager  installed  by  Netscape  upon  start  up  defines  a  security  manager  whose 
checkPropertyAccess( )  method  throws  a  SecurityException  when  the  key  is  one  of  the  following 
properties: 

1.  "java.home"  (Java  installation  directory) 

2.  "java.class.path"  (the  user's  class  path) 

3.  "user.name"  (user's  account  name) 

4.  "user.home"  (user's  home  directory) 

5.  "user.dir"  (current  working  directory) 

When  the  Java  interpreter  starts,  it  runs  with  a  "null"  security  manager,  that  is  one  that  grants  all 
requests.  That  way  the  application  can  run  like  any  other  application  with  user  privileges. 

If  the  application  needs  more  security,  it  can  "install"  an  instance  of  the  SecurityManager  class  using 
System.setSecurityManager( ). 

See  TinyHttpd.java  and  Tiny  HttpdSecurity  Manager  Java. 
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CS2973  Student  Data  Form 


This  form  is  ONLY  for  the  students  enrolled  in  or  auditing  the  CS2973  course. 
Please  submit  comments  about  the  course  or  this  website  via  the  Feedback  Form. 


Name:  (Last, First,  MI)  (required) 

Email  Address:  (required) 

NPS  login:  (if  different  than  above) 

How  did  you  hear  about  this  course? 
If  "Other"  please  describe  below: 

What  Operating  Systems  are  you  familiar  with: 

Mac  Unix  Windows  3.1  Windows  95  Windows  NT  Other  None 

If  "Other"  please  describe  below: 

What  programming  languages  have  you  used? 

Remarks  about  your  past  assignments  or  experiences: 
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If  your  browser  does  not  support  forms,  you  may  send  email  to 
Java  @  nps.  navy,  mil 
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CS2973  Student  Homework  SubmissionForm 


Usage:  a  URL  must  be  submitted  for  each  exercise  assigned  in  class.  The  URL  must  be  submitted  prior 
to  the  due  time  in  order  to  receive  full  credit. 


What  is  your  email  address?  (the  one  used  for  class) 


What  is  the  complete  URL  to  your  assignment: 
(ex:  http://www.my. server/~mylogin) 
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Java  links 

CS2973 

links  for  the  Java  course 

The  Java  Handbook:  Examples 

Java  in  a  Nutshell  Code  Examples 

Handy  Software 

History  of  the  Internet 

Hobbes'  Internet  Timeline 

Object-Oriented  Programming  Concepts:  A  Primer 

Java  knowledge 

JavaWorld  -  IDG's  magazine  for  the  Java  community 

Strong  Java  Mailing  List  WWW  Gateway 

Java  FAQ  and  tutorial 

Ryan's  HoJava  HowTo! 

The  Java  Developer 

Java  in  India 

Some  Questions  and  Answers  about  using  Java  in  Computer  Science  Curricula 

Gordon  H.  Bradley  home  page 

Teach  Yourself  Java:  Errata 

Java  Land 

The  Java(tm)  Page 

Hostile  Applets  Home  Page 

Java  Programming 

Java  sources 

Dgclock  in  Java 

Dr.  Smith's  Java(tm)  Comer 

Java  links 

TeamJava  JAVA  Links 
Java  Resources 
Stratum  Technologies 
Diva  for  Java 
JAVA  IDE  Comparison 

Java  tools 

Free  Tools  for  Java(tm) 
Jlpr,  the  PostScript  Applet 


I  wan  van  Rienen's  homepage 
Java  Disassembler 
README.rtfd 

Java  tutorials 

API  User's  Guide 

Animation  in  Java  Applets 

Converting  Objects  to  Strings 

GUI  Programming  using  Java 

Index  of  all  Fields  and  Methods 

Java  Packages 

Methods  for  Adding  UI  Components 

Packages 

SunWorld  Online  -  January  -  Java  Developer 

The  AWT  Tutorial 

Creating  a  User  Interface 

The  Java  Package  Tutorial 

Trail  Map:  The  Java  Language  Tutorial 

Java  -  cool  applets 

http://www.nyx.net/~jbuzbee/mail.html 
ChessLive! 

Java  script 

Intellectual  Technologies,  Incorporated 
Websys  JavaScript  Menu 
JavaScript  Index 


web  stuff 


Instant  NPS  Webpage 

The  WWW  Security  FAQ 

CGI/PERL 

perl  Programming 

Smiley' s  CGI/PERL  Source  Page 

perl 

Matt's  Script  Archive 

HTML  Hacking  Scripts 

Dale  Bewley's  Perl  Scripts  and  Links 

The  Scripts  Home 

Perl  Tutorial 


APPENDIX  B  -  LAB/HOMEWORK  ASSIGNMENTS 

The  following  Appendix  provides  copies  of  the  CS2973  course  Lab  exercises  and 
Homework  exercises  as  they  appear  on  the  Web  pages.  This  Lab  and  Homework 
Assignments  were  created  in  HTML  format  and  are  located  at  the  web  page  address  of 
http://vislab-www.nps.navy.mil/~java. 
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CS2973  Homework  Info 

•  Required  WWW  Setup 

•  Assignments 

O  Homework  1 
O  Homework  2 
O  Homework  3 
O  Homework  4 
O  Homework  5 

The  CS2973  homework  exercises  constitute  60%  of  your  final  grade. 

Critical  items  are  in  bold.  Please  adhere  closely  to  these  instructions  so  that  all  of  the  items  are 

standardized. 

Required  WWW  Setup 

If  you  do  not  have  one,  create  a  home  page  for  yourself  on  the  the  NPS  Web  server.  For  more 
information  look  at  the  VisLab's  HowTo  or  try  a  Page  Generator  to  get  up  and  running  quickly.  Ensure 
that  your  correct  email  address  is  listed  on  the  page. 
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Homework  1 
applet  name 


Student  Name 
date  due 


This  applet  uses  the  system  clock  to  determine  the  time  and  uses  the  AWT  to  update  with  the  paint 

method. 


Win_Clock.java 
Documentation 
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CS2973  Homework  Exercise  1  (10  points) 

Due  22  JUL  96,  1300 

Create  a  home  page  for  yourself  on  the  the  NPS  Web  server  that  has  in  it  a  local  and  nonlocal  Applet 
running.  Your  page  should  look  as  follows: 

Your  Name 

Local  line  Applet  running  here 

•  Curriculum 

•  Email  Address 

Nonlocal  Applet  of  your  choice  running  here 

The  layout  of  the  page  must  be  as  above.  You  must  create  the  line  Applet  using  Rotator .  j  ava  and  the 
image  file  Line .  gif.  Rotator  Java  is  capable  of  rotating  multiple  images  within  a  single  file  and  it 
doesn't  care  what  the  images  look  like;  it  simply  cycles  through  them  at  some  specified  rate  of  frames 
per  second.  In  our  case  the  frames  come  from  Line  .gif.  The  Java  Source  code  can  be  found  in 

sourcecode  and  the  image  file  in  images,  each  Subdirectories  of  ~java/public_html/course 

The  line  Applet  has  three  parameters.  See  the  source  code  where  they  are  documented.  In  addition  to 
setting  the  width  parameter  to  500  pixels  and  the  height  parameter  to  10  pixels,  also  set  the  frame  rate  to 
30  and  the  background  color  to  be  the  background  color  of  your  home  page. 

The  nonlocal  Applet  must  come  from  outside  NPS  and  be  referenced  using  a  URL  and  the  codebase  tag 
of  an  Applet.  See  Section  15  of  Java  in  a  Nutshell  for  a  description  of  this  tag.  Do  not  download  your 
own  personal  copy  of  the  relevant  class  file.  For  each  Applet,  you  should  provide  some  text  that  gets 
displayed  instead  by  those  Web  browsers,  like  NCSA  Mosaic,  that  are  not  Java  powered. 

When  completed,  the  applets  should  reside  in  a  web  page  titled  "hwl.html"  on  any  world  readable 
server,  though  NPS  is  preferred.  Email  the  URL  of  the  page  to  java@nps.navy.mil. 
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CS2973  Homework  Exercise  2  (15  points)  j 

Due  5  AUG  1996,  1300 

Create  a  standalone  Java  application  strBuf comp  such  that 
Java   StrBuf Comp   argl   arg2 

outputs  a  negative  number  if  argl  <  arg2,  0  if  argl  =  arg2,  and  a  positive  number  if  argl  >  arg2,  where  < 
is  lexicographic  ordering  with  respect  to  the  UNICODE  character  set.  This  is  the  same  ordering  one 
finds  in  a  dictionary. 

Define  a  class  strBuf  comp  with  a  main  method  and  a  method  called  compwith  that  takes  two 
StringBuffer  objects  si  and  s2  and  returns  a  negative  number  if  si  <  s2,  0  if  si  =  s2,  and  a  positive 
number  if  si  >  s2.  Method  compwith  should  use  method  charAt  which  throws 

StringlndexOutOf BoundsException.  You  are  not  allowed  to  use  the  String  method  compareTo. 

The  main  method  must  have  an  exception  handler  to  catch  the  exception  above  and  to  catch 
ArrayindexOutof  BoundsException.  For  the  former  exception,  the  handler  should  just  output  that  the 
exception  has  been  caught.  The  latter  exception  is  thrown  if  an  attempt  is  made  to  index  into  the 
command-line  argument  array  at  a  position  that  does  not  contain  a  String  object.  (Such  is  the  case  if  the 
user  supplies  less  than  two  arguments.)  So  for  the  second  kind  of  exception,  the  handler  should  output 
the  following  usage  line: 

usage:  Java  StrBuf Comp  argl  arg2 

There  will  be  no  need  to  prepare  an  HTML  file  for  this  exercise.  After  the  due  date  specified  above,  I 

will  look  for  the  class  file  ~username/public_html/cs2973/hw2 /StrBuf Comp.  classwhereusername 
is  your  user  name.  I  will  run  it  and  grade  it  accordingly,  so  it  should  be  readable  by  all.  I  recommend 
that  your  source  code  for  the  class  file  also  be  readable  by  all,  AFTER  THE  DUE  DATE,  of  course. 
There  is  no  need  to  email  anything  to  user  java.  No  email! 
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CS2973  Homework  Exercise  3  (20  points) 

Due  12  AUG  1996,  1300 

This  exercise  is  simple.  You  have  to  do  only  two  things.  First  create  a  directory 

~usemame/public_html/cs2973/hw3 

that  has  only  two  files,  one  called  Binary  Tree  Java  and  another  called  BinaryTree.class  which  is  the  class 
file  created  by  compiling  Binary Tree.java.  Second,  set  your  CLASSPATH  environment  variable  by 
entering  the  following  at  the  command  line: 

setenv  CLASSPATH  ".:/h/joshua_u2/java/PUBLIC" 

Now  here  is  how  I  intend  to  grade  you.  I  will  go  to  the  directory  you  created  in  step  (1)  above,  with  my 
CLASSPATH  variable  set  as  above,  and  then  run  the  appletviewer  on  -java/PUBLIC/DictBox.html.  Thi< 
is  a  dictionary  box  Applet  that  allows  me  to  create  a  table  of  words  by  entering  a  word  at  a  time  and 
pushing  the  insert  button.  It  also  allows  me  to  lookup  words  that  I  previously  entered  in  this  way.  If 
you're  interested  in  seeing  how  it  works,  then  go  to  the  -java/PUBLIC  directory  and  fire  it  up  using  the 
appletviewer  on  DictBox.html.  When  I  run  the  Applet  from  within  your  directory,  namely 
~username/public_html/cs2973/hw3, 1  expect  to  see  the  same  behavior.  That's  why  it  is  very  important 
that  your  Binary  Tree  .Java  file  be  correct.  When  will  you  know  it's  correct?  When  it  satisfies  the 
specification  below. 

Binary  Tree.java  must  implement  two  methods,  one  called  insert  and  the  other  called  lookUp.  The 
former  inserts  a  string  into  a  table.  The  latter  attempts  to  look  for  a  given  string  in  the  table,  returning  the 
string  itself  if  found  and  throwing  SymbolNotFoundException  otherwise.  Their  type  signatures  are 
given  by  the  abstract  class  SymbolTable  in  -java/PUBLIC/SymbolTable.java.  You  must  extend  this 
abstract  class  with  a  class  called  Binary  Tree  that  implements  these  two  methods  using  a  binary  search 
tree  as  the  search  data  structure. 
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CS2973  Homework  Exercise  4  (15  points) 

Due  19  AUG  1996,  1300 

Overview 

This  exercise  is  merely  extending  the  BinaryTree  class  into  a  class  called  Persistent .  class  and 
adding  the  Load  and  Save  functionality  to  the  Persistent . class.  The  DictBox. java  already  provides 
the  applet  with  four  buttons:  Insert,  LookUp,  Load,  and  SaveAs,  and  from  HW3  the  Insert  and  LookUp 
functionality  should  be  there... your  mission  is  to  now  allow  a  user  to  Load  strings  from  the  Dictionary 
file  into  the  Binary  Tree  structure  and  then  save  the  Binary  Tree  structure  back  to  the  file  named 
Dictionary.  If  you're  interested  in  seeing  how  it  works,  then  go  to  the  -java/PUBLIC  directory  and  fire  i 
up  using  the  appletviewer  on  DictBox.html.  When  I  run  the  Applet  from  within  your  directory,  namely 
~useraame/public_html/cs2973/hw4, 1  expect  to  see  the  same  behavior.  That's  why  it  is  very  important 
that  your  Persistent.java  file  be  correct. 

Tasks: 

1.  First  create  a  directory  with  the  proper  PERMISSIONS  named: 
~username/public_html/cs2973/hw4 

that  has  only  three  (3)  files: 

•  Persistent.java  -  this  is  the  file  that  extends  the  Binary Tree.class  (ie  class  Persistent  extends 
BinaryTree  {) 

•  Persistent.class  -  which  is  the  class  file  created  by  compiling  Persistent.java 

•  Dictionary  -  file  that  contains  test  data  that  you  will  add  to... please  leave  the  strings  first,  second, 
third,  and  fourth  in  the  Dictionary  file  for  grading.  (Do  not  rename  the  Dictionary  File,  it  is  hard 
coded  in  the  DictBox.java  file,  filename  =  "Dictionary "...and  finally  please  makesure  the  file 
PERMISSION  on  this  file  is  r  and  w  ie  chmod  766  Dictionary... this  will  allow  me  to  test  it 
properly.) 

2.  Set  your  CLASSPATH  environment  variable  by  entering  the  following  at  the  command  line: 
setenv  CLASSPATH  ".:/h/joshua_u2/java/PUBLIC" 

3.  Add  the  Load  and  SaveAs  Functionality: 

•  Persistentclass  -  The  new  DictBox.class  applet  has  2  new  buttons  added  to  it.  Note  how  they 
work  but  you  are  not  responsible  for  this  file  only  the  Persistent  .Java  file.  In  this  class  you 
will  extend  the  BinaryTree .  class  and  add  the  file  load  and  saveAs  methods.  Note  the  calls  from 

DictBox.java 

•  saveAs  method  of  the  Persistent.class  -  This  saves  the  Binary  Tree  to  the  Dictionary  file.  This 


method  will  look  like  this: 

public  void  saveAs (String  dest)  throws  IOException  { 
} 

Note  that  the  save  As  method  throws  an  IOException. 

•  load  method  of  the  Persistent. class  -  This  method  will  look  like  this: 

public  boolean  load (String  filename)  { 

} 

This  method  loads  the  Binary  Tree  with  the  strings  into  the  Dictionary  file. 

Standards: 

Now  here  is  how  I  intend  to  grade  you.  I  will  go  to  the  directory  you  created  in  step  (1)  above,  with  my 
CLASSPATH  variable  set  as  above,  and  then  run  the  appletviewer  on  -java/PUBLIC/DictBox.html. 
When  I  test  your  code  I  will  conduct  the  following  tests: 

•  Insert  string  into  structure  via  Insert  Button. 

•  LookUp  string  in  structure  via  LookUpButton  - 1  will  use  the  Lookup  of  first  and  second  strings 

•  Load  the  Dictionary  File  via  the  Load  Button.  (This  will  allow  a  merge  of  the  Binary  Tree  in 
memory  with  the  one  read  in  from  the  Dictionary  File) 

O  Insert  string  then  Load  from  Dictionary  file:  the  structure  should  contain  all  strings 
O  Load  from  Dictionary  file,  then  Insert  string:  the  structure  should  contain  all  strings. 

•  I  should  get  a  not  found  response  when  I  attempt  to  load  the  Dictionary  file  and  it  is  not  present. 

•  SaveAs  to  the  file  should  put  the  elements  in  preorder. 

•  The  following  files  should  be  in  your  directory:  Presistent.java,  Presistent.class,  and  Dictionary. 

•  The  Dictionary  file  should  have  the  new  elements  added  to  it  when  a  SaveAs  is  done. 

•  Comments  LAW  Java  Style  Guide. 
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CS2973  Homework  Exercise  5  (25  points) 

Due  23  SEP  1996,  1300 

Rewrite  the  CS2973  Student  Data  HTML  Form  as  a  standalone  Java  form.  You  are  required  to  use  the 
GridBagLayout  class.  Components  of  the  form  should  not  grow  with  window  resizing.  Replace  the 
"Send  Info!!"  button  with  a  "Save  form"  button  which  writes  the  contents  of  the  form  to  a  local  file  in 
HTML  with  the  same  format  as  the  form.  The  file  to  which  the  HTML  is  written  should  be  obtained 

through  use  of  class  FileDialog. 

You  will  note  that  the  form  has  an  option  menu,  editable  text  areas  and  checkboxes  which  are  not  radio 
buttons.  You  must  preserve  the  behavior  of  the  HTML  form  in  your  Java  form.  We  recommend  that  you 
use  Example  5-4  of  Java  in  a  Nutshell  as  a  template  for  completing  this  exercise.  Also  see,  in  the  same 

book,  pages  1 12-1 14  and  255-257  for  descriptions  Of  the  GridBagLayout  and  GridBagConstraints 
classes. 

We  recommend  that  you  define  a  class  called  StudentFormComponents  that  loosely  corresponds  to 
AllComponents  on  pg  109  of  the  Nutshell.  Add  the  form  widgets  to  the  frame  and  give  a  main  method 
with  no  event  handler,  which  will  allow  you  to  focus  initially  on  just  the  form  layout.  Then  extend  this 
class  with  one  called  StudentFormEvents  which  does  ALL  event  handling  and  has  its  own  main  method. 
You  should  not  have  to  modify  StudentFormComponents  whatsoever.  Create  a  directory 
~username/public_html/cs2973/hw5  containing  the  files  StudentFormComponents.java  and 
StudentFormEvents.java  and  their  byte  code  as  well.  And  again,  as  a  reminder,  please  give  everyone 
read  permission  to  these  files  at  the  time  the  assignment  is  due. 

When  viewed  by  Netscape,  the  HTML  you  generate  should  look  like  this.  So  take  a  look  at  the  HTML 
for  this  using  "view  document  source",  to  see  what  you  should  generate.  Remember  you  must  inspect 
the  state  of  your  checkboxes  and  output  "checked"  as  part  of  the  HTML  tag  input  so  that  Netscape  will 
display  a  checked  box. 
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CS2973  Project  Proposal 

This  form  is  used  to  submit  the  project  proposal. 

Name:  (Last,  MI,  First)  (required) 
Email  Address:  (required) 
Project  Title: 
Description  of  Project: 
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Final  Project  Suggestions  ] 

1.  The  rudiments  of  a  structured  editor  for  Java.  A  structured  editor  allows  one  to  edit  parse  trees 
rather  than  strings  and  to  build  a  program  by  filling  in  placeholders  from  choices  made  available  in 
a  menu. 

2.  Extend  the  dictionary  Applet  to  graphically  display  binary  trees.  The  Applet  might  create  a  Frame 
or  ScrollBar  to  display  binary  trees  with  at  most  16  nodes.  This  would  be  a  nice  tool  to  illustrate 
how  such  trees  can  become  unbalanced  if  strings  are  input  in  nearly  sorted  order. 

3.  Design  a  pocket  Simon  Applet.  A  pocket  Simon  has  one  audio  tone  associated  with  each  of  four 
different  colors.  The  game  begins  with  Simon  playing  one  randomly-chosen  tone  and  flashing  its 
corresponding  color.  The  user  must  respond  by  pressing  that  color.  Now  Simon  replays  the  sound 
and  randomly  chooses  another  tone  so  that  the  user  must  now  replay  the  two-tone  sequence.  Each 
time  the  user  correctly  replays  the  entire  sequence,  Simon  adds  yet  another  randomly-chosen  tone 
to  it  for  the  user  to  replay.  The  game  ends  when  the  user  can  no  longer  replay  the  entire  sequence 
at  which  time  Simon  may  choose  to  offend  you.  Remember,  Simon  can  vary  the  replay  time  so 
that  the  user  hears  the  entire  sequence  more  quickly.  Oh  boy! 

4.  Implement  a  client-server  application;  you  might  use  as  your  starting  point  the  chat  client/server 
application  described  in  the  September  issue  of  Dr.  Dobb's  Journal. 

All  of  the  above  projects  constitute  a  multi-person  effort.  If  by  Aug  26,  user  Java  has  not  received  a  final 
project  proposal  from  you  then  you  will  be  assigned  to  work  on  one  of  the  above  projects,  perhaps  with 
a  colleague. 
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APPENDIX  C  -  RESOURCE  GUIDE 

The  Resource  Guide  provides  a  guide  for  the  Hardware  and  Software  resources 
required  to  implement  a  course  using  HTML  and  the  Java  programming  language.  The 
Resource  Guide  provides  a  recommended  set  of  hardware  and  software  for  the  Macintosh, 
Solaris,  and  Windows  operating  systems. 
A.         Macintosh  Operating  System  Version  7.5  or  better: 
1.         Classroom 

(a)  Hardware 

(1)  Mactionish  Computer  with: 

-  68  series  processor  or  better 

-  36  MB  RAM 

-  400  MB  Free  Harddrive  Space 

-  NIC  or  MODEM  connected  to  local  area  network  with 


Internet  Access 


(2)  Overhead  projection  device  that  connects  to  a  computer 

(3)  Display  screen 

(4)  Power  cord  and  surge  protector 
(b)  Software 

(1)  Mac  O/S  7.5  or  better 

(2)  Fetch  3.1  or  better  for  File  Transferring 

(3)  Sun  Java  Development  Kit  (JDK)  version  1.1 

(4)  NCSA  Telnet  2.6  or  better  for  Telnet  application 
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with: 


(5)  Email  application  such  as  EUDORA 

(6)  Web  Browser  that  supports  Java  such  as  Netscape  3.0 
(c)  Miscellaneous 

( 1 )  Pointer  for  screen 

(2)  Audio  speakers  for  Computer 

(3)  Spare  projector  light  bulb 
Lab  Area 

(a)  Hardware 

(1)  One  Macintosh  Computer  per  student  and  one  for  instructor 

-  68  series  processor  or  better 

-  36  MB  RAM 

-  400  MB  Free  Harddrive  Space 

-  NIC  or  MODEM  connected  to  local  area  network  with 


Internet  Access 


(2)  Overhead  projection  device  that  connects  to  computer 

(3)  Display  screen 

(4)  Power  cord  and  surge  protector 
(b)  Software  (per  machine) 

(1)  Mac  O/S  7.5  or  better 

(2)  Fetch  3. 1  or  better  for  File  Transferring 

(3)  Sun  Java  Development  Kit  (JDK)  version  1.1 
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(4)  NCSA  Telnet  2.6  or  better  for  Telnet  application 

(5)  Email  application  such  as  EUDORA 

(6)  Web  Browser  that  supports  Java  such  as  Netscape  3.0 
(c)  Miscellaneous 

(1)  Pointer  for  screen 

(2)  Audio  speakers  for  Computer 

(3)  Spare  projector  light  bulb 
B.         Solaris  Operating  System  Version  2.3  or  better: 

1 .  Classroom 

(a)  Hardware 

(1)  One  Solaris  Workstation  for  instructor  with: 

-  68  series  processor  or  better 
- CDROM 

-  36  MB  RAM 

-  400  MB  Free  Harddrive  Space 

-  NIC  or  MODEM  connected  to  local  area  network  with 


Internet  Access 


(2)  Overhead  projection  device  that  connects  to  a  computer 

(3)  Display  screen 

(4)  Power  cord  and  surge  protector 
(b)  Software  (per  machine) 

(1)  Solaris  O/S  2.3  or  better 
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(2)  FTP  Tool  3.1  or  better  for  File  Transfering 

(3)  Sun  Java  Development  Kit  (JDK)  version  1.1 

(4)  Email  application  such  as  Open  Mail 

(5)  Web  Browser  that  supports  Java  such  as  Netscape  3.0 
(c)  Miscellaneous 

( 1 )  Pointer  for  screen 

(2)  Audio  speakers  for  Computer 

(3)  Spare  projector  light  bulb 
2.          Lab  Area 

(a)  Hardware 

(1)  One  Solaris  Workstation  per  student  and  for  insu-uctor  with: 

-  68  series  processor  or  better 

-  36  MB  RAM 

-  400  MB  Free  Harddrive  Space 

-  NIC  or  MODEM  connected  to  local  area  network  with 


Internet  Access 


(2)  Overhead  projection  device  that  connects  to  a  computer 

(3)  Display  screen 

(4)  Power  cord  and  surge  protector 
(b)  Software  (per  machine) 

(1)  Solaris  O/S  2.3  or  better 

(2)  FTP  Tool  3.1  or  belter  for  File  Transferring 
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(3)  Sun  Java  Development  Kit  (JDK)  version  1.1 

(4)  Email  application  such  as  Open  Mail 

(5)  Web  Browser  that  supports  Java  such  as  Netscape  3.0 
(c)  Miscellaneous 

(1)  Pointer  for  screen 

(2)  Audio  speakers  for  Computer 

(3)  Spare  projector  light  bulb 
Windows  95/NT  Operating: 

1.         Classroom 

(a)  Hardware 

(1)  Personnel  Computer  with: 

-  Pentium  series  processor  or  better 
- CDROM 

-  36  MB  RAM 

-  400  MB  Free  Harddrive  Space 

-  NIC  or  MODEM  connected  to  local  area  network  with 


Internet  Access 


(2)  Overhead  projection  device  that  connects  to  a  computer 

(3)  Display  screen 

(4)  Power  cord  and  surge  protector 
(b)  Software 

(1)  Windows  95/NT  O/S 
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(2)  WS  FTP  PRO  or  better  for  File  Transferring 

(3)  Sun  Java  Development  Kit  (JDK)  version  1.1 

(4)  Telnet  or  better  for  Telnet  application 

(5)  Email  application  such  as  EUDORA 

(6)  Web  Browser  that  supports  Java  such  as  Netscape  3.0 
(c)  Miscellaneous 

(1)  Pointer  for  screen 

(2)  Audio  speakers  for  Computer 

(3)  Spare  projector  light  bulb 
Lab  Area 

(a)  Hardware 

(1)  One  Personnel  Computer  per  student  and  instructor  with: 

-  Pentium  series  processor  or  better 
- CDROM 

-  36  MB  RAM 

-  400  MB  Free  Harddrive  Space 

-  NIC  or  MODEM  connected  to  local  area  network  with 


Internet  Access 


(2)  Overhead  projection  device  that  connects  to  a  computer 

(3)  Display  screen 

(4)  Power  cord  and  surge  protector 
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(b)  Software 

(1)  Windows  95/NT  O/S 

(2)  WINFTP  2.0  or  better  for  File  Transferring 

(3)  Sun  Java  Development  Kit  (JDK)  version  1.1 

(4)  Telnet  or  better  for  Telnet  application 

(5)  Email  application  such  as  EUDORA 

(6)  Web  Browser  that  supports  Java  such  as  Netscape  3.0 

(c)  Miscellaneous 

(1)  Pointer  for  screen 

(2)  Audio  speakers  for  Computer 

(3)  Spare  projector  light  bulb 
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APPENDIX  D  -  A  LOOK  AT  HTML 

The  World  Wide  Web  (WWW)  allows  both  information  dissemination  and 
information  collecting  through  the  capability  of  the  Hypertext  Markup  Language  (HTML). 
HTML  is  the  programming  language  that  has  been  standardized  to  be  interrupted  by 
WWW  browsers  (ie  Mosaic,  Netscape,  or  Microsoft  Internet  Explore).  The  current 
HTML  standard  is  HTML  3.0.  The  HTML  resides  on  a  Hypertext  Transport  Protocol 
(HTTP)  server  which  when  invoked  downloads  the  HTML  to  the  requested  client  where  it 
is  interrupted  by  the  clients'  WWW  browser.  The  clients'  WWW  browser  then  displays 
the  Web  page,  the  HTML  downloaded,  in  the  WWW  browser  in  a  WYSIWYG  (what  you 
see  is  what  you  get)  format. 

Representing  traditional  slide-oriented  lectures  in  HTML  requires  learning  the 
mechanics  of  the  HTML  and  a  set  of  software  tools  for  Internet  implementation.    First 
we  will  look  at  the  HTML  Mechanics  followed  by  the  recommended  tools. 

A.       HTML  MECHANICS 

HTML  is  the  language  used  to  create  the  documents  for  the  World  Wide  Web. 
Although  most  browsers  can  display  any  document  written  in  plain  text,  there  are 
advantages  to  writing  documents  using  HTML.  When  HTML  documents  are  read  by 
applications  specifically  designed  for  the  Web,  i.e.  browsers  or  Web  browsers,  they  can 
include  formatting,  graphics,  and  hyperlinks  to  other  documents.    In  Figure  D.  1  below, 
the  Netscape  browser  is  displaying  the  HTML  page  for  the  CS  2973  course.  Note  that  the 
underlined  bullets  are  actual  hyperlinks  that  can  be  clicked  on  to  display  other  HTML 
pages. 
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Netscape  -  [Course  Index] 


File     Edit     View     Go     Bookmarks     Options     Directory 
Window     Help 


CS2973  Course  Index 


CS2973  Administrative  Notes 


CS2973  Course  Syllabus 
CS2973  Homework  Assignments 


CS2973  Final  Project 
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Figure  D.l.  Example  of  HTML  page  viewed  through  the  Netscape  Browser. 

Two  other  ways  to  format  text  are  Rich  Text  Format  (RTF)  and  Postscript  (PS) 
which  concentrate  on  the  appearance  of  a  document.    Unlike  RTF  and  PS  formatted 
documents,  HTML  concentrates  on  the  structure  of  a  document  instead  of  emphasis  on 
typefaces  and  illustrations.  HTML  emphasizes  the  need  for  basic,  working  components. 
For  example  HTML  marks  the  headings,  normal  paragraphs,  lists,  numbering,  and 
addressing.  Additionally,  HTML  allows  you  to  dynamically  update  the  Web  pages,  which 
can  be  displayed  over  the  Internet,  with  the  use  of  a  World  Wide  Web  (WWW)  browser. 

HTML  is  a  simple  implementation  of  Standard  Generalized  Markup  Language 
(SGML).  HTML  is  a  fairly  simple  language  to  use,  however,  there  are  editors  to  generate 
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it.  HTML  editors  allow  users  to  format  documents  in  HTML  format  without  having  to 
learn  the  HTML  scripting  language.  HTML  editors  can  be  useful,  especially  if  writing 
massive  quantities,  but  they  are  not  necessary. 

In  general,  HTML  commands  begin  with  a  <  and  end  with  a  >.  The  commands, 
not  usually  case  sensitive,  are  "container"  or  "separator"  commands.  However,  there  are 
numerous  exceptions.  A  container  consists  of  a  beginning  command  and  an  ending 
command.  The  commands  are  applied  to  the  text  between  the  beginning  and  ending 
commands.  A  container  command  is  the  title  command,  surrounding  the  text  designated 
as  the  document's  title.  For  example:  <title>  and  </title>.  A  separator  command 
is  the  command  used  to  insert  a  linebreak  <br>. 

Non  printable  characters  or  "white  space"  is  generally  ignored  in  HTML.    Leaving 
a  blank  line  in  your  document  will  not  create  a  blank  line  when  the  document  is  displayed 
in  a  browser  unless  you  use  the  "preformatted"  HTML  tag.  (i.e.   <pre>  and  <  /pre> ) . 

Not  every  element  common  to  typical  documents  is  included  in  HTML. 
Occasionally,  there  are  problems  converting  documents.  The  commonly- used  version  of 
HTML  does  not  support  equations  and  support  for  tables  is  still  relatively  new.  The 
implementation  of  many  features  also  varies  among  browsers.  For  example,  tables  may 
look  quite  different  from  browser  to  browser. 

There  is  a  paradigm  shift  involved  using  HTML,  especially  for  users  used  to 
controlling  the  look  of  a  page.  On  the  Web,  the  user  and  reader  have  more  control  over 
the  look  of  documents  than  most  publishers. 
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Some  publishers  attempt  to  circumvent  the  formatting  limitations  in  HTML  by 
using  an  abundance  of  graphics  or  non-standard  HTML.    However,  using  these 
techniques  to  make  documents  look  "just  right"  in  one  particular  browser,  such  as 
Netscape  or  Microsoft  Explorer,  often  results  in  documents  that  cannot  be  displayed 
properly  in  other  browsers. 

It  is  far  better  to  use  general  HTML  commands  than  complex,  non-standard 
commands  because  users  see  uniform  documents  regardless  of  the  browser  they  use. 

A  HTML  page  consists  of  the  following  structures: 

1.  Heading. 

Every  HTML  document  should  start  with  a  heading.  The<html>  command 
should  be  the  first  text  inserted  at  the  top  of  every  document.  The  last  text  in  a  document 
should  be  the  ending  command, </ html  >.  Headings  are  structured  in  levels. 

a.  Heading  levels: 

HTML  is  best  suited  for  documents  with  a  fairly  rigid  structure  with  definite 
outlines  for  headings,  subheadings  and  lists.  Although  not  required,  it  is  good  practice  to 
write  documents  with  heading  "levels"  which  reflect  the  document's  organization.  For 
example:  The  first  heading  is  a  "level  1"  heading,  subheadings  should  be  "level  2"  and  so 
on.  Most  browsers  recognize  at  least  four  heading  levels.  There  is  support  in  HTML  for 
more  than  four,  but  the  browser  only  gives  distinct  styling  on  four  levels.  After  the  fourth 
level,  it  is  difficult  to  distinguish  between  the  heading  levels.  Beyond  four  levels,  the  best 
solution  is  to  convert  a  single  page  document  into  multiple  pages. 
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NOTE:  The  heading  commands  look  like<hX>  and  </hX>,  where  X  is  the 
heading  level  (1-6).  In  most  documents  on  the  Web,  the  first  heading  is  a 
duplicate  of  the  document's  title, 
b.  Head. 

The  top  of  the  document  should  have  a  section  for  heading  information  surrounded 
by  the  <head>  and  </head>  commands  (Figure  D.2  and  D.3).  Several  items  of 
information  should  be  the  header,  even  though  most  browsers  ignore  this  information.  A 
title  must  always  be  in  the  heading  title.  The  title  is  surrounded  by  the<title>  and 
</title>  commands.  The  title  of  a  document  is  not  normally  displayed  as  part  of  the 
page,  but  is  displayed  in  a  special  section  in  most  browsers.  For  example:  Mosaic  puts 
the  title  in  a  Document  Title  box  under  the  menu.  Netscape  displays  the  title  on  the  Title 
Bar.  The  title  should  be  both  descriptive  and  short  enough  to  fit  on  one  line 
[HTML/CGI95]. 


<html> 
<head> 

<title>Course  Index</title> 
</head> 
<body> 

<hl>Hello  World</hl> 
</body> 
</html> 


Figure  D.2.  Example  of  HTML  with  the  first  heading. 
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Netscape  -  [Course  Index] 


mi^ 


File     Edit     View     Go     Bookmarks     Options     Directory 
Window     Help 


Hello  World 


Ml 


Figure  D.3.  Example  of  HTML  in  the  browser. 
2.  Body. 

The  "body"  of  a  document  is  everything  after  the  head  and  should  be  marked  with  the 
<body>  and  </body>  commands  (Figure  D.4  and  D.5). 


<html> 

<head> 

<title>Course 

Index</t 

itle> 

</head> 

<body> 

HTML 

text 

of 

web 

page 

goes 

here 

</body> 

</html> 

Figure  D.4.  Example  of  HTML  structure  with  body  command. 

Note:  Remember  white  space  is  not  directly  interpreted,  so  all  commands 
can  be  on  one  line  when  necessary.  Additionally,  the  body  can  consist  of 
numerous  HTML  commands  to  give  the  document  the  desired  look. 
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Netscape  -  [Course  Index] 


File     Edit     View     Go     Bookmarks     Options     Directory 
Window     Help 


HTML  text  of  web  page  goes  here 
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Figure  D.5.  Example  of  HTML  in  the  browser. 


a.    Paragraphs. 


Normal  paragraphs  are  separated  with  the  <p>  command.  This  is  an  useful 
command  not  normally  used  as  a  container,  although  it  can  be  used  if  necessary.  In 
HTML,  version  3.0,  the  <p>  command  is  designed  as  a  container  so  all  paragraphs  begin 
with  a  <p>  and  end  with  a  </p>    (Figure   D.6    and   D.7).  Most  documents  on  the 
web  simply  use  the<p>  command  as  a  separator,  but  most  browsers  display  paragraphs 
correctly  whether  you  use  <p>  as  a  separator  or  as  a  <p>container</p>.  Using  the 
container  form  of  the  paragraph  separator  is  the  recommended  way  to  formal  paragraphs. 


<html> 

<head> 

<title>Course 

Index</title> 

</head> 

<body> 

<hl>The  title 

goes  here.</hl> 

<p>  This  is  a 

sample  paragraph . </p> 

<h2>This  is  a 

subheading</h2> 

<p>HTML  works 

great  in  education. </p> 

</body> 

</html> 

Figure  D.6.  Example  of  HTML  with  paragraphs  and  a  subheading. 
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Netscape  -  [Course  Index] 
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File     Edit     View     Go     Bookmarks     Options     Directory 
Window     Help 


The  title  goes  here. 


This  is  a  sample  paragraph. 
This  is  a  subheading 

HTML  works  great  in  education. 


if 
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Figure  D.7.  Example  of  HTML  in  the  browser. 

b.    Lists. 

There  are  three  kinds  of  lists  in  HTML:  ordered,  unordered,  and  a  special 
definition  list  (Figure  8  and  9). 

(1)  Ordered  lists.  Browsers  insert  list  element  numbers.  This  is  convenient  for 
authors  because  inserted  or  deleted  items  in  a  sorted  list  are  automatically  updated  to 
reflect  the  correct  numbering  order.  An  ordered  list  begins  with<ol>  and  ends  with 


</ol>. 


(2)  Unordered  lists.  Bullets  mark  each  item  in  the  list.  The  kind  of  bullet  icon 


displayed  is  up  to  the  browser.  For  example:  DOS  may  use  asterixes  or  dashes.  MAC 
may  use  dots  or  circles.  An  unordered  list  begins  with  <ul  >  and  ends  with  <  /  ul  >. 
NOTE:  In  both  ordered  and  unordered  lists,  the  individual  items  are 
designated  with  a  <  1  i  >  command.  It  is  not  necessary  to  separate  items  in 
a  list  with  <p>  commands.  Additionally,  you  can  also  nest  lists  to  get  an 
outline  effect. 
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<html> 

<head> 

<title>Course  Index</title> 

</head> 
<body> 

<hl>The  title  goes  here</hl> 

This  is  a  sample  paragraph. 

The  majority  of  most  documents  contain 

this  type  of  construct. 

<p> 

<h2>This  is  a  subheading</h2> 

<p>HTML  is  good  for  education. 

ordered  List:<p> 

<ol> 

<li>  first  item. 
<li>  second  item. 
<li>  third  item 
</ol> 

<p>unordered  list:</p> 
<ul> 

<li>  an  item. 

<li>  another  item. 

<li>  here's  a  nested  list 

<ul> 

<li>  a  nested  item 

<li>  another  nested  item 

</ul> 

<li>  the  last  item 

</ul 

</body> 

</html> 


Figure  D.8.  Example  with  multiple  lists. 
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Netscape  -  [Course  Index] 


IHIS 


File     Edit     View     Go     Bookmarks     Options     Directory     Window 
Help 


The  title  goes  here 

This  is  a  sample  paragraph.  Most  documents  contain  this  type  of  construct. 

This  is  a  subheading 

HTML  is  good  for  education,  ordered  List: 

1 .  first  item. 

2.  second  item. 

3.  third  item 

unordered  list: 

•  an  item. 

•  another  item. 

•  here's  a  nested  list 

□  a  nested  item 

□  another  ne  ste  d  item 

•  the  last  item 
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Figure  D.9.  Example  of  the  above  list  when  viewed  with  the  browser. 

(3)         Definition  lists.  A  definition  list  is  very  flexible  and  is  used  only  for  lists 
needing  explanatory  text  for  each  item.  Each  item  in  the  list  has  two  parts  -  a  term 
indicated  with  the  <dt>  command  and  a  definition  which  uses  the  <dd>  command.  The 
list  itself  starts  with  a<dl>  command  and  closes  with  a<  /dl>  command  (Figure  10  and 
11)  [HTML/CGI95]. 
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<dl> 

<dt> 

First  Term 

<dd>  First  term 

'  s 

definition. 

<dt> 

Second  term 

(or 

title) 

<dd> 

Text  that  explains  the 

secc 

nd 

term. 

</dl> 

Figure  D.10.  Example  of  a  sample  definition  list. 


Netscape  -  [Course  Index] 
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Figure  D.ll.  Example  of  what  it  would  look  like  in  the  browser. 

3.  Links. 

Links  are  what  make  Web  documents  unique.  Unfortunately,  creating  a  link  is  slightly 

complicated.  The  most  complex  part  is  the  URL  pointing  to  the  resource  link. 

a.  URL  (Universal  Resource  Locator).  The  address  of  a  document  or  resource. 

protocol : / /machine . name [ :port ] /directory/document . name 
The  protocol  is  the  transfer  protocol  used  to  reach  the  document  or  resource.  On 

the  Web,  it  is  typically  "HTTP",  but  it  can  also  be  numerous  other  things  -  ftp,  gopher, 
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telnet,  etc.  The  machine  .  name  is  the  name  of  the  host  where  the  document  resides  - 
z.e.  vis  lab-www.  nps  .navy  .mil.  The  ":port"  portion  of  the  address  is  optional  and 
is  only  necessary  when  the  protocol  is  listening  to  a  non-standard  TCP  port  number.  The 
standard  port  number  for  HTTP  is  80.  There  are  numerous  Web  servers  on  the  Internet 
using  non-standard  ports,  such  as  port  8000.  To  reach  a  gopher  at  something  than  port  70 
or  telnet  at  something  other  than  port  23,  you  have  to  put  in  a  port  number. 

The  easiest  way  to  access  a  URL  in  a  HTML  document  is  to  copy  the  URL  into 
the  document  via  a  web  browser;  Netscape,  Mosaic,  or  Cello.  For  example:  in  Mosaic, 
copy  the  text  in  the  Document  URL  field  near  the  top  of  Mosaic's  window.  In  Cello,  click 
on  the  link  with  the  right  mouse  button  and  choose  the  "copy"  command.  In  Netscape 
either  copy  the  text  in  the  "Location"  box  at  the  top  of  the  Window  or  click  on  the  link 
with  the  right  mouse  button  and  choose"  copy  link  to  clipboard." 

b.  Putting  Links  in  HTML  documents.  The  HTML  command  for  putting  a  link 
into  a  document  is:  < a   href  =  "URL">   text   of    link   </a>    (Figure    12 
and   13).      Put  the  URL  in  the  quotes  following  the  "  hr e  f  =  "  and  put  the  text  of  the 
link,  the  part  that  users  will  click  or  select  to  activate  the  link,  after  the  >  and  before  the 
</a>    [HTML/CGI95]. 
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<html> 

<head> 

<title>Th 

is  is 

my  title</title> 

</head> 

<body> 

<hl>The 

title 

goes  here</hl> 

<p>  This 

is  a 

sample  paragraph 

<a  href= 

"http 

vis lab-www. nps .navy 

.mil">here 

</a>.</p 

> 

<h2>This 

is  a 

subheading</h2> 

<p>HTML 

is  good  in  education. 

<a  href= 

"http: 

//vislab- 

www . nps . 

navy .mil /-java/planner . 

html" 

> 

Java  Stuff </a> 

</p> 

</body> 

</html> 

Figure  D.12.  Example  using  links. 
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Netscape  -  [This  is  my  title] 
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File     Edit     View     Go     Bookmarks     Options 
Directory     Window     Help 


The  title  goes  here 

This  is  a  sample  paragraph,  here.. 

This  is  a  subheading 


HTML  is  good  in  education.  Java  Stuff 


Js/iSil  lOscament:  Done 
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Figure  D.13.  Example  of  what  it  would  look  like  in  the  browser. 

4.  Images. 

It  is  not  difficult  to  put  an  image  into  a  web  page.  One  of  the  greatest  advantages 
of  using  the  Web  is  creating  and  sharing  documents  across  platforms.  However,  restraint 
is  key.  Users  frequently  turn  off  in-line  images  to  increase  performance.  Even  with  fast 
network  access  to  the  Internet,  some  users  are  annoyed  by  documents  loaded  down  with 
images.  However,  a  dash  of  colorful  images  maybe  needed  to  make  a  point.  Additionally, 
in  education  the  use  of  images  are  instrumental  in  conveying  an  idea.. 

In  order  to  add  an  image  you  must  use  the  <IMG    SRC  =  "  image  .  gi  f  > 
command.  Images  added  to  a  document  need  to  be  converted  into  Graphics  Interface 
Format  (GIF)  or  Joint  Photographic  Experts  Group  (JPEG)  format.  There  are  a  number  of 
tools  currently  in  use.  Industry  standards  include  XV  on  the  UNIX  platform  and 
PaintShop  Pro  on  the  Windows/NT  platform.  These  tools  are  valuable  for  converting  and 
editing  images  to  be  placed  into  web  page  documents.  The  location  does  not  have  to  be  a 
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full  URL,  but  it  can  be.  The  same  trick  can  be  used  for  normal  links,  as  well  as  images. 
There  is  not  a  noticeable  difference  in  speed  using  relative  URLs  opposed  to  full  URLs.  It 
is  really  just  a  matter  of  user  preference. 

The  HTML  command  for  inserting  an  image  at  the  current  position  is: 

(1)  Relative  URL:  < IMG   SRC="name_of_image  .  gif  /  jpeg"> 

(2)  Full  URL:  <IMG    SRC  ="  vis  lab - 

www.nps .navy .mil/~java/name_of_image . gif / jpeg"> . 

NOTE:  It  is  possible  to  display  a  GIF/JPEG  images  stored  almost  anywhere,  including 
on  the  Internet,  but  it  is  more  complex.  It  is  simpler  to  create  a  directory  named 
images  in  which  to  store  all  images  (ie.  ~your_html_directory/images). 

There  is  an  optional  way  to  use  the  IMG  command.  A  "suggestion"  can  be  made  to 
the  browser  to  align  the  image  in  a  particular  way  with  respect  to  the  surrounding  text. 
For  example,  use  the  "  a  1  i  gn  =  "  directive.  The  alignment  choices  are  "  t  op  "  , 
"middle",  or  "bottom",  which  indicate  where  the  base,  bottom  edge,  of  the  image 
should  be  in  relation  to  the  base  line  of  the  surrounding  text  (Figure  D.14). 


<img  align="top"  src=" . /image .gif ">  Top  Text. 
<img  align="middle"  src" . /image .gif ">  Middle  Text. 
<img  align="bottom"  src" . /image. gif ">   Bottom  Text. 


Figure  D.14.  Example  of  aligning  items  with  commands. 
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When  viewed  in  a  browser,  the  HTML  code  described  in  Figure  D.14 
would  be  displayed  as  in  Figure  D.15. 


fiv»S&I 


Netscape  -  [Course  Index] 


File     Edit     View     Go     Bookmarks     Options     Directory 
Window     Help 


Top    Text. 
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Figure  D.15.  Example  of  how  it  looks  in  the  browser. 

Another  useful  option  is  to  use  the  "alt"  directive  to  "suggest"  a  text-only 
alternative  for  browsers  that  do  not  support  in-line  images. 


<img 

alt  =  ' 

' [sample  image 

#1]" 

src=" 

. /image . gif">  Sample  Text. 

<img 

alt  =  ' 

' [sample  image 

#2]" 

src=" 

. /image .gif">  Sample  Text. 

<img 

alt  =  ' 

' [sample  image 

#3]" 

src=" 

. /image. gif">  Sample  Text. 

Figure  D.16.  Example  using  "alt"  tag. 

For  users  on  a  text-only  browser,  i.e.  W3-mode  of  Emacs  or  Lynx,  these  items 
appear  "[sample  image]"  instead  of  [IMAGE]  (Figure  16  and  17).  Some  web  servers  use 
this  directive  to  display  icons  for  image-oriented  and  simple  word  links.  For  example 
"  [  Home  ]     [  Next  ]  "  for  text-only  browsers  [HTML/CGI95]. 
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Netscape  -  [Course  Index] 


File     Edit     View     Go     Bookmarks     Options     Directory 
Window     Help 


[sample  image  #1] 
[sample  image  #2] 
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Figure  D.17.  Example  of  HTML  in  the  browser. 

5.    Applet  Tag. 

The  Applet  Tag  is  a  Java  specific  HTML  tag.  It  is  composed  of  several  elements. 


<APPLET 

CODEBASE 

=  applet -url 

CODE  =  applet-filename 

WIDTH  = 

pixel-width 

HEIGHT  = 

pixel-height 

[ALT  =  a 

lternate-text] 

[NAME  = 

applet-name] 

[ALIGN  = 

alignment] 

[VSPACE 

=  vertical-pixel-space] 

[HSPACE 

=  horizontal-pixel-s 

pace] 

[<PARM  NAME  =  parameter  VALUE 

=  value>] 

[<PARM  NAME  =  parameter  VALUE 

=  value>] 

[altermate 

-html] 

</APPLET> 

Figure  D.18.  Example  of  the  Java  HTML  Tag  semantics. 
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The  first  element  is  a  < applet  >  which  indicates  the  start  of  the  Applet  Tag.  The 
second  element  is  the  CODE   ="HelloWorld .  class",  which  indicates  the  file 
containing  a  compiled  applet  (bytecode)  (Figure  18,  19  and  20  ).  The  third  and  fourth 
elements  of  the  Applet  Tag  indicate  the  width  and  the  height  of  the  applet  in  pixels. 
The  upper  left  comer  of  the  applet  is  always  at  x-coordinate  0  and  y-coordinate  0.  The 
width  of  this  applet  is  275  pixels  and  the  height  of  this  applet  is  35  pixels.  Additionally, 
the  Applet  Tag  can  have  numerous  variable  parameters  that  can  be  passed  from  the 
HTML  page  to  the  applet,  although  not  required.  The  variable  parameters  are  passed  to 
the  applet  via  the  [<parm  name  =  parameter  value  =  vaiue>].  The  fifth  element  is 
the  </ applet  >  which  signals  termination  of  the  applet  tag  [Nutshell96]. 


<APPLET 

CODE      =  "HelloWorld. class" 

WIDTH   =  "2  00", 

HEIGHT  =  "200" 

> 

[<PARM  NAME  =  "BGCOLOR"  VALUE  = 

"red"> ] 

</APPLET> 

Figure  D.19.  Example  using  Java  Applet  in  HTML  Page. 
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Netscape  -  [Course  Index] 
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Hello  World 


Figure  D.20.  Example  of  HTML  in  the  browser. 

B.        HTML  SOFTWARE  TOOLS 

In  this  section  we  describe  some  of  the  tools  that  are  useful  in  developing  Web 
applications.  The  minimum  tools  necessary  are:  a  text  editor  to  create  and  edit  the 
HTML  documentation;  an  image  editor  supporting  GIF  and  JPEG  images  which  allow 
editing  and  resizing  of  images;  a  file  transfer  protocol  (FTP)  tool  allowing  the  transfer  of 
files  between  workstations  and  the  HyperText  Transfer  Protocol  (HTTP)  server;  and  a 
web  browser  for  viewing  the  created  HTML  documents. 

Recommended  tools  for  developing  a  web  page  document; 

1.  HTML  authoring  tools: 

a.  WINDOWS  -  Homesite  2.0, 
http://www.dexnet.com/index.html7/apps/hoinesite.html 

b.  MACINTOSH  -  Page  Mill  2.0, 
http://www.adobe.com/prodindex/pagemill/main.html 

c.  UNIX  -  HotMetal  3.0,  http://www.sq.com/products/hotmetal/hmp- 
org.htm 
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2.  Imaging  Tools: 

a.  WINDOWS  -  Paint  Shop  Pro  4.1,  http://www.jasc.com/psp.html 

b.  MACINTOSH  -  Photo  Shop  4.0, 
http://www.adobe.com/prodindex/photoshop/main.html 

c.  UNIX  -  XV,  http://www.sun.com/sunsoft/catlink/xv/xv.html 

3.  FTP  Tools. 

a.  WINDOWS  -  WS  FTP  PRO,  http://www.ipswitch.com/pd_wsftp.html 

b.  MACINTOSH  -  Fetch  3.0.1,  ftp:lldartmouth.edu/publmacl 

c.  UNIX  -  FTP  Tool,  http://www.sun.com 

4.  Browsers: 

a.  WINDOWS  -  Netscape  3.0,  http://www.netscape.com 
Microsoft  Explorer,  http://www.microsoft.com 

b.  MACINTOSH  -  Netscape  3.0,  http://www.netscape.com 
Microsoft  Explorer,  http://www.microsoft.com 

c.  UNIX  -  Netscape  3.0,  http://www.netscape.com 

Many  of  the  HTML  development  tools  we  found  to  be  very  similar  in 
performance  and  functionality.  The  basic  recommendation  is  to  find  a  set  of  tools  you  feel 
comfortable  with  and  that  best  meets  your  needs. 

C.       SUMMARY 

The  use  of  HTML  to  create  the  course  lecture  notes  proved  to  be  valuable  in 
allowing  students  to  view  notes  in  the  classroom,  as  well  as  on  the  Internet  at  anytime. 
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Additionally,  the  use  of  HTML  allowed  the  course  notes  to  be  updated  and  distributed  to 
students  immediately.  To  view  the  course  lecture  notes,  see  Appendix  A,  Lecture  Notes, 
or  http://vislab-www.nps.navy.mil/~java. 
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APPENDIX  E  -  A  LOOK  AT  THE  JAVA  AWT 

This  appendix  provides  an  overview  of  the  Java  Abstract  Windowing  Toolkit  (AWT).  A 
comprehensive  treatment  of  Java  and  its  other  API  packages  is  outside  the  scope  of  this 
appendix.  For  additional  information,  the  books  "Core  Java"  [CoreJava96],  "Exploring  Java" 
[Exploring96]  and  "Java  in  a  Nutshell"  [Nutshell96]  are  recommended. 

A.    The  Java  Programming  Language 

There  is  no  doubt  Java  has  received  much  attention  since  its  official  announcement  by  Sun 
Microsystems  in  May  1995.  Whether  much  of  the  excitement  surrounding  Java  is  really 
justified  remains  to  be  seen.  However,  it  is  clear  it's  a  simple,  yet  flexible,  alternative  to  C++ 
for  many  applications. 

Java  is  an  Object-Oriented  Programming  language  orignally  designed  for  writing 
code  to  control  devices  such  as  VCR's,  set-top  boxes  for  interactive  TV,  and  other 
assorted  appliances.  Its  primary  application  today,  Web  programming,  was  largely 
unforeseen  when  it  was  originally  designed  in  1991  and  called  Oak.  Now  it  is  used  to 
develop  "Applets",  relatively  small  programs  downloaded  from  an  HTTP  server  by  a  Java- 
enhanced  Web  browser  (e.g.  Netscape  Navigator),  and  executed  by  the  browser  on  the 
client's  machine.  The  downloaded  code  comprises  instructions  of  a  virtual  machine  (the 
Java  VM)  and,  therefore,  can  run  on  a  variety  of  different  platforms  (e.g.  Solaris  and  NT) 
as  long  as  these  platforms  implement  the  Java  VM.  This  kind  of  portability  is  one  of  the 
major  reasons  for  the  widespread  appeal  of  Java. 

Another  major  reason  for  Java's  appeal  is  its  support  for  bringing  interactive  content 


181 


Java  Compiler 

(translator) 


£ 


] 


Java  Byte  Code 

(this  code  is  interpreted  by  any  Java  Interpreter) 


Java  Interpreter 

(one  Interpreter  per  platform) 


1 


^sr 


Figure  E.l      Java  Flow  Diagram 

to  Web  pages.  Prior  to  Java,  Web  page  interaction  was  limited  to  static  HTML  forms  and 
CGI  scripts.  The  Java  Application  Programming  Interface  (API)  provides  a  useful  set  of 
methods  for  writing  general  graphic  user  interfaces  (GUI's).  The  API  is  a  collection  of 
"packages",  each  containing  "class"  specifications. 

B.     The  Java  AWT 

The  Abstract  Windowing  Toolkit  is  a  platform-independent  windowing  toolkit 
supporting  many  of  the  basic  needs  of  a  GUI  (e.g.  windows,  menu  bars,  buttons,etc). 
The  toolkit  is  regarded  as  abstract  because  it  serves  as  an  interface  between  Java 
applications  (and  Applets)  and  native  GUI  libraries  such  as  Motif.  Details  of  the 
underlying  GUI  library,  which  are  platform-specific,  are  hidden  from  Java  programs 
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making  the  Java  program  more  portable  between  operating  systems.  Current  platforms 
the  AWT  has  been  implemented  on  include  Microsoft  Windows95/NT,  Motif  and 
Macintosh  7.5.  Because  the  windowing  subcomponents,  buttons,  scrollbars,  etc.,  are 
actually  provided  by  the  native  windowing  system's  "peer  objects",  there  may  be 
differences  between  platforms  (Figure  E.4).  For  instance,  the  file  dialogue  on  the 
Macintosh  is  different  from  that  of  Microsoft  Windows.  In  order  for  the  Java  AWT  to  be 
portable,  it  must  have  an  interface  developed  for  each  specific  platform  allowing  the  AWT 
to  recognize  the  native  system's  peer  objects.  In  overall  appearance,  the  AWT  is  similar  in 
functionality  to  early  versions  of  Motif.  The  Java  AWT  provides  the  "highest  common 
factor"  of  functionality  across  a  wide  variety  of  native  windowing  toolkits,  (see  Figure 
E.l). 

At  first  glance,  the  structure  of  the  AWT  is  complex.  The  AWT  consists  of  23 
classes,  consisting  of  nine  different  components  added  to,  and  then  laid  out,  by  five 
different  layout  managers  in  two  different  types  of  containers  (panel  or  window).  The 
AWT  is  simply  defined  as  a  set  of  nested  components,  starting  from  the  outermost 
component,  i.e.  window,  all  the  way  down  to  the  smallest  UI  component,  adhering  to  the 
"is  a"  inheritance  model,  (see  Figure  E.2).  Additionally,  there  are  a  variety  of  event 
handling,  menu,  fonts  and  graphics  classes  used  in  supporting  the  AWT.  However,  the 
AWT  alone  is  not  adequate  for  complete  GUI  development.  Threads,  audio,  I/O,  and 
network  classes  should  be  implemented  to  produce  full  functioning  Applets. 
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Now  we  will  look  at  the  java.awt.Component  class  and  its  subclasses  consisting  of: 

•  Subcomponents 

•  Containers 

•  Windows 

•  Panels  and  Layouts 

C.    The  java.awtComponent  Class 

Components  are  the  window  icons  with  which  the  user  interacts  -  Buttons, 
TextAreas,  Scrollbars,  etc.  Basically,  Components  are  the  visible  GUI  controls  added  to  a 
Container.  Anything  derived  from  the  java.awt.Component  class  can  be  a  Component. 
Some  common  methods  used  in  the  java.awt.Component  package  are: 

getBackground() 

setBackground(Color) 

getFont() 

setFont(Font) 

mouseDown(Event,  int,  int) 

show() 

resize(int,  int) 

paint(Graphics) 

update(Graphics) 

move(int,  int) 
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C.l  Subcomponents 

Subcomponents  and  their  constructors  are  added  using  the  add(Component)  or 
addltem (String)  method  and  removed  with  removeQ.  Adding  a  component  doesn't 


Component 


Container 


Window 

Frame 

Dialog 

Panel 


Applet 


Subcomponents 


Button 


Canvas 


Checkbox 


Choice 


Label 


List 


Scrollbar 


TextComponent 


Figure  E.2     Structure  of  AWT  (java.awt  package) 

necessarily  create  the  native  Subcomponent  (peer  Subcomponent)  for  that  component,  but 
simply  inserts  the  component  into  the  component  hierarchy.  The  nativeSubcomponentis 
only  instantiated  when  packQ  or  show()  is  called  on  a  window  or  when  you  add  a 
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component  to  a  container  whose  native  subcomponent  is  already  created.  The 
Subcomponents  provide  basic  controls,  labels,  and  methods  for  creating  custom 
components  for  all  types  of  GUI  interfaces.  Many  trigger ACTION_EVENTs  for 
interactive  applications. 

The  Button  creates  a  simple  on-screen  button  the  user  can  push.  A  string  within  the 
constructor  shows  up  as  a  label  on  the  button. 

Button(); 
Button(String); 
The  Canvas  provides  a  semantic-free,  nearly  abstract  class  which  inherits  its 
functionality  from  the  Component  class.  The  Canvas  is  well  suited  for  building  custom 
components.  It  is  ready  for  use  as  a  drawing  surface  and  allows  the  implementation  of 
event  handling.  When  the  Canvas  is  extended,  inherited  methods  are  overwritten  to 
provide  the  desired  functionality. 

The  Checkbox  has  a  selected/deselected  toggle  control  and  may  also  have  a  label.  It 
may  be  initialized  with  either  true  or  false  boolean  value.  A  series  of  checkboxes  in  the 
same  CheckboxGroup  will  be  mutually  exclusive. 

Checkbox(); 
Checkbox(String); 

Checkbox(String,  CheckboxGroup,  Boolean); 
The  Choice  creates  a  pop-up  menu  on  the  screen  when  the  user  clicks  on  it.  Items 
are  listed  in  the  order  added  to  the  class  with  addltem.  Only  the  first  item  added  will  be 
displayed  on  top. 
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Choice  C  =  new  ChoiceO; 
C.addltemf'First  choice"); 
The  Label  displays  a  static  line  of  text,  although  it  may  be  constructed  empty  and  set 
at  a  later  time.  Labels  also  have  an  alignment  property  of  LEFT,  CENTER  or  RIGHT 
stored  as  an  integer. 

Label(); 
Label(String); 
Label(String,  int); 
The  List  displays  a  scrolling  list  of  items  of  which  one  or  many  may  be  selected.  A 
List  can  specify  the  number  of  lines  to  be  visible  or  use  the  size  of  the  container  as  the 
default.  A  boolean  is  set  to  determine  if  multiple  selections  are  permitted. 
List  itemlist  =  new  List(l,  true); 
itemlist.addltem ("first  item"); 
itemlist.addltemO'second  item"); 
The  Scrollbar  displays  the  familiar  windows  control  for  moving  through  a  range  of 
values.  The  orientation  is  set  to  HORIZONTAL  or  VERTICAL.  The  initial  value  or 
position  of  the  scrollbar  index  is  set  to  an  integer  value.  The  visibility  or  overall  area 
displayed  is  specified  in  pixels.  The  minimum  and  maximum  size  of  the  scrollable  area  are 
also  specified  in  pixels  as  integers. 

Scrollbar(orientalion); 

Scrollbar(orientation  int,  initial_value  int,  visible 

int,  minimum  int,  maximum  int); 
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The  TextComponent  superclass  of  TextArea  and  TextField  supplies  many  methods 
which  allow  the  programmer  to  control  the  behavior  or  place  restrictions  on  a  TextArea 
or  TextField.  For  instance,  the  user  can  restrict  the  behavior  of  a  TextArea  or  TextField 
such  that  the  text  within  the  TextArea  or  TextField  is  editable  or  not  editable. 

The  TextField  creates  field  with  a  single,  editable  line  of  text.  The  number  of 
columns  in  the  text  field  may  be  set  with  an  integer,  and  the  text  initially  displayed  is  set 
with  a  String.  TextField  also  has  the  useful  setEchoChar()  method  which  is  useful  for 
password  fields. 

TextFieldO; 

TextField(int); 

TextField(String); 

TextField(String,  int); 
TextArea  creates  a  multi-line  box  for  text  entry.  The  TextArea  may  be  any  height 
and  width-scrollbars  are  added  by  default.  The  int  arguments  set  the  number  of  rows  and 
columns  (respectively)  of  the  area.  The  appendText()  method  allows  text  to  be  added  to 
the  TextArea  incrementally.  Other  methods  include  inserfText(String,  int)  and 
replaceText(String,  int,  int).  Like  the  TextField  class,  TextArea  has  four  constructors. 

TextAreaQ; 

TextArea(int,  int); 

TextArea(String); 

TextArea(Slring,  int,  int); 
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C.2  Containers 

The  Container  class  is  an  abstract  subclass  of  Component  and,  is  designed  to  group 
together  related  components.  A  Container  may  also  contain  other  Components.  The  two 
subclasses  are  Windows,  which  provide  the  windows  to  contain  Components,  andPanels, 
which  group  Components  within  the  area  of  an  exiting  window.  In  general,  Components 
must  be  added  to  a  Container  before  they  can  be  used  or  modified.  They  use  the  add() 
method  with  one  or  two  arguments  depending  on  the  LayoutManager  used.  Common 
methods  used  in  Containers  are: 

•  add(Component); 

•  add(String,  Component); 

•  remove(Component); 

•  getComponentsO; 

•  setLayout(LayoutManager); 

•  getLayout(); 
C.3  Windows 

When  an  application  is  written  for  a  GUI  using  the  AWT,  the  Window  class  provides 
the  framework  for  a  basic  standalone  process.  A  standalone  process  is  a  Java  application 
which  executes  within  the  operating  systems  API  without  the  use  of  thebrowser's 
framework.  The  Window  is  the  next  major  subclass  of  Container.  It  provides  a  top  level 
window  with  no  borders  or  menu  bar.  Although  it  is  rarely  called  directly,  it  does  provide 
the  important  event  handles  WINDOW_DESTROY,  WINDOWJCONIFY, 
WINDOW_DEICONIFY  and  WINDOW_MOVE.  The  two  Window  subclasses  are 
Frame  and  Dialog. 
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The  Frame  subclass  of  Window  provides  a  container  for  all  associated  components 
used  in  the  main  window  of  the  program.  The  Frame  has  many  predefined  convenience 
methods  and  may  have  a  specified  title,  menu  bar,  icon  and  cursor.  The  Frame  does  not 
need  to  be  displayed  physically  within  any  other  type  of  container  or  component,  it  can 
stand  freely  on  its  own.  The  show()  and  hide()  methods  make  the  Frame  appear  and 
disappear  when  needed.  The  setResizable(boolean)  determines  whether  the  user  can 
resize  the  Frame.  Frame  is  the  only  container  class  supporting  theMenuComponents  class 
and  subclasses. 

The  MenuComponent  class  is  extended  from  the  Object  class,  so  it  is  not  a 
component  that  can  be  usable  anywhere  or  instantiated  directly.  The  subclasses  using 
MenuComponent  are  MenuBar,  Menu,  Menultem  and  CheckboxMenuItem.  The 
MenuBar  sets  up  the  platform-dependent  group  of  menus,  typically  across  the  top  of  the 
window.  Each  menu  and  the  drop-down  list  of  options  is  represented  by  a  Menu  object. 
Each  object  on  the  list  is  a  Menultem.  Menu  is  implemented  as  a  subclass  of  Menultem, 
so  sub-menus  can  be  made  by  adding  one  menu  to  another.  For  example, 
CheckboxMenuItem  is  a  subclass  of  Menultem  class. 

The  Dialog  class  provides  a  simple,  encapsulated  dialog  box  which  blocks  further 
user  input  until  dismissed.  Dialogs  are  dependent  on  other  windows.  If  the  parent 
window  is  iconified  or  destroyed,  the  Dialog  box  mirrors  its  behavior.  A  handy  subclass 
of  Dialog  is  the  FileDialog  which  brings  up  the  native  file  chooser  window  to  allow  local 
file  selection.  FileDialog  currently  has  Load  and  Save  buttons  built  in,  but  other 
operations  can  also  be  supported. 


190 


Dialog(Frame  parent,  boolean  modal)  no  title  on  window. 
Dialog(Frame  parent,  String  title,  boolean  modal) 
FileDialog(Frame  parent.  String  title) 

C.4  Panels  and  Layouts 

A  Panel  is  one  of  the  most  generic,  yet  concrete,  containers  available  which  can  be 
displayed  on-screen.  Once  a  component  is  added  to  a  Panel,  it  can  be  manipulated  using 
the  move(),  resize()  or  reshape()  methods  inherited  from  Component.  Each  Panel  or  sub- 
panel  may  be  treated  as  a  Container  in  its  own  right.  To  offer  more  control  and  flexibility 
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Figure  E.3    Sample  PanelTest.class  Applet  (see  Appendix  E-l) 

in  how  components  are  displayed  within  a  container,  the  abstract  classLayoutManager  is 
used.  The  final  appearance  of  a  component  is  determined  by  which  LayoutManager  is 
used,  and  the  order  in  which  items  are  added  to  the  container.  Figure  E.3  is  a  graphic 
display  of  the  use  of  the  Panel  class  and  the  LayoutManagers,  while  Appendix  E-l 
provides  the  Java  source  code  which  created  this  Applet. 

Layouts  define  how  Components  are  "laid  out"  within  a  Container.  There  are  five 
predefined  subclasses  of  the  LayoutManager.  Since  the  LayoutManager  class  is  abstract, 
it  cannot  be  used  directly.  Instead,  it  must  be  a  sub-class  with  its  own  functionality  or, 
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use  a  derived  class  defined  in  the  AWT  -  i.e.  BorderLayout,  CardLayout,  GridLayout, 
FlowLayout,  etc.  The  actual  appearance  of  the  AWT  components  on-screen  is  determined 
by  the  order  in  which  they  are  added  to  the  Panel,  (and  the  LayoutManager  class  the 
panel  is  currently  using  to  lay  out  the  screen.)  The  LayoutManager  class  determines  how 
portions  of  the  screen  are  sectioned  and  how  components  within  the  Panel  are  placed. 

The  BorderLayout  arranges  components  around  the  edges  of  the  container  according 
to  an  area  specified  in  the  instantiation  of  the  component.  The  areas  of  choice  are:  north, 
south,  east,  west,  and  center.  The  area  in  which  components  are  added  is  important.  If  a 
center  component  is  added  it  gets  allocated  all  remaining  space.  The  other  areas  expand 
only  as  much  as  necessaiy  to  keep  all  available  space  filled.  The  argument  add()  method  is 
used  to  add  a  component  with  BorderLayout.    If  a  gap  is  desired  between  components, 
the  horizontal  and  vertical  pixel  values  are  set  with  the  setLayout  method.BorderLayout 
is  the  default  layout  manager  for  all  Windows,  such  as  Frames  and  Dialogs. 

Add("direction",  new  ComponentC'string")); 

BorderLayout(int  horizontalGap,  int  verticalGap); 
The  CardLayout  gets  its  name  because  only  one  visible  display  space  is  visible 
although  many  Containers  may  use  the  same  space.  Like  a  stack  of  playing  "cards", 
components  may  be  displayed  by  calling  the  methods  firstQ,  last(),  next(),  previousQ,  or 
show()  to  get  a  specific  card.  Again,  the  argument  add(String  name.  Component  comp)  is 
required  with  the  String  being  an  identifier  for  that  component.  The  order  in  which 
components  are  added  determines  their  order  in  the  "deck". 

Panel  cardl  =  new  PanelQ; 

card  1  .setLayout(new  CardLayoutQ); 
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add("first",cardl); 

card  1  .show(card  1  /'first"); 
The  GridLayout  provides  an  easy  method  for  organizing  components  in  a  grid.  All 
components  are  placed  in  equally  sized  cells,  and  placed  in  the  container  in  the  order  in 
which  they  are  added,  starting  in  the  top  row  from  left  to  right.  If  a  window  containing  a 
GridLayout  is  resized,  the  cells  grow  or  shrink  so  that  all  the  space  available  to  the 
container  is  used.  The  GridLayout  constructor  includes  the  number  of  rows  and  columns 
required.  As  an  option,  horizontal  and  vertical  gaps  maybe  specified  in  pixels.  At  least 
one  of  the  row  arguments  or  column  arguments  must  be  non-zero. 

GridLayout(int  rows,  int  columns); 

GridLayout(int  rows,  int  columns,  int  horizontalGap,  int  verticalGap); 
The  GridBagLayout  is  much  more  flexible  than  GridLayout  as  it  allows  specific 
components  to  span  multiple  rows  or  columns.  The  characteristics  of  each  component  is 
optionally  set  with  GridBagConstraints.  Various  options  may  be  set  including  anchor 
position;  grid  position,  which  may  be  relative  or  absolute;  the  number  of  horizontal  and 
vertical  cells  occupied;  fill  direction;  margin  insets;  and  directional  weights. 

GridBagLayout(); 
The  FlowLayout  is  probably  the  simplest  to  use.  It  puts  components  in  a  row  until 
the  horizontal  space  is  full,  then  shifts  to  multiple  lines.  Horizontal  and  vertical  gaps  may 
be  specified  with  a  default  of  five  pixels.  The  alignment  of  the  components  on  the  rows 
may  be  LEFT,  RIGHT,  or  CENTER  justified  when  the  FlowLayout  is  created. 
FlowLayout  is  the  default  layout  manager  for  all  Panels. 
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FlowLayoutQ; 

FlowLayout(ini  alignment); 

FlowLayout(int  alignment,  inl  horizonialGap,  int  verdcalGap); 
C.4.1.  Applet 

An  Applet  is  a  subclass  of  a  Panel  designed  to  tie  the  Container  to  the  browser  of  the 
applet  viewer.  Applets  inherit  their  paint()  and  update()  methods  from  the  Applet  class, 
which  hierarchically,  inherit  them  from  the  AWT  Component  class  (Figure  E.2).  The 
repaint()  method  saves  time  and  resources  by  only  redrawing  the  part  of  the  component 
that  has  changed.  Since  Applets  are  Panels,  they  display  the  same  features  as  all  Panels. 
Because  Applets  can  appear  in  a  browser  or  viewer  window,  they  do  not  need  to  build  a 
Window.  Applets  have  the  ability  to  use  resources  such  as  audio  clips,  images,  or  other 
data  files  on  the  internet  since  they  are  accessed  via  the  Universal  Resource  Locator 
(URL).  For  security  reasons,  restrictions  may  apply  if  the  applet  is  loaded  over  the 
network.  An  Applet  loaded  over  a  network  may  not: 

•  Define  any  system  properties 

•  Read  or  write  files  on  the  local  host 

•  Start  programs  on  the  local  host 

•  Load  libraries  or  define  native  methods 

•  Make  a  network  connection  to  any  computer  other  than  the  one  from 
which  the  applet  was  itself  loaded 

Applets  are  capable  of  doing  many  functions  other  applications  cannot.  Applets 
loaded  locally  are  not  restricted.  Applets  can  load  other  HTML  documents  in  a  browser, 
and  may  continue  running  after  exiting  the  window  which  invoked  the  Applet.  Overall, 
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Applets  are  a  very  innovative  and  powerful  way  to  send  dynamic  applications  over  the 
Internet,  without  having  to  worry  about  the  native  machines  operating  system 
environment. 

GUIs  and  Windowing  systems  use  event-driven  models  rather  than  procedural-grab- 
the-input-yourself  models.  The  O/S  polls  constantly  for  events.  When  an  event  is 
located,  it  is  relayed  to  the  program  and  the  program  decides  how  to  handle  that  event. 
An  Event  object  is  created  when  a  user  triggers  it,  by  clicking  a  button  or  pressing  a  key 
on  a  Component.  The  Component  deliverEvent()  method  takes  the  Event  object  from 
the  top-most  Component,  such  as  a  browser  or  a  Window,  and  sends  it  down  to  the 
lowest  Component,  such  as  a  Button.  Once  the  target  component  is  reached,  the  AWT 
allows  each  Component  to  handle  the  event  at  every  step  of  the  Component  hierarchy. 
At  each  component  level,  the  Event  handler  may  modify  the  Eventinstance  before  it  is 
passed  up,  stop  the  Event  from  being  processed  further,  or  react  in  some  other  way  by 
doing  interim  processing.  Each  Event  object  includes: 

•  The  type  of  the  event  (a  key  press  or  mouse  click) 

•  The  object  that  was  the  "target"  of  the  event  (the  Button  clicked) 

•  A  timestamp  indicating  when  the  event  occurred 

•  The  location  (x,y)  where  the  event  occurred 

•  The  key  that  was  pressed  (for  keyboard  events) 

•  An  arbitrary  argument  (such  as  the  string  displayed  on  the  Component) 

•  The  state  of  the  modifier  keys  when  the  event  occurred 
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Unhandled  events  are  passed  to  the  parent  container  via  postEvent()  so  they  get  a 
chance  to  deal  with  the  event.  Components  can  respond  to  events  by  implementing  a 
custom-written  handleEvent()  method  or  by  using  the  default  (Component)  definition  of 
handleEvent()  which  simply  calls  a  method  specific  to  the  event  type.  The  following 
events  routinely  need  to  be  handled  in  a  typical  Java  Applet 

•  ACTION_  EVENT  -  The  ACTION_EVENT  event  occurs  when  you  press  a 
button,  select  a  menu,  etc 

•  MOUSE.DOWN  -  The  MOUSE_DOWN  event  occurs  when  the  mouse  button 
is  clicked  down 

•  KEY_ACTION  -  The  KEY_ACTION  event  occurs  when  a  key  on  the 
keyboard  is  pressed 

•  WINDOW_DESTROY  -  The  WINDOW_DESTROY  event  occurs  when  the 
window  of  the  object  is  closed 

D.     Peer  Objects  (Package  java.awt.peer). 

The  java.awt.peer  package  is  a  subpackage  of  the  AWT  package  providing  interfaces 
implemented  by  the  native  windowing  system.  The  java.awt.peer  package  does  the  work 
behind  the  scenes  allowing  the  Java  program  to  interface  seamlessly  with  specific  platform 
native  peer  objects.    The  native  peer  objects  are  the  objects  in  the  native  windowing 
system  allowing  a  button,  scrollbar  or  other  GUI  interfaces  to  be  produced  in  accordance 
with  the  native  windowing  system  methods.  The  native  peer  objects  are  derived  from  the 
abstract  java.awt.Component  class,  (  Figure  E.2).  There  is  a  native  peer  object 
corresponding  to  each  java.awt.Component  class  object.  A  button  displayed  by  a 
Macintosh  windowing  system  is  different  from  a  button  displayed  by  Windows  95/NT 
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windowing  system.  The  power  behind  the  java.awt.peer  package  is  that  it  is  neutral.  It 
simply  makes  a  request  to  the  native  windowing  system  for  a  Button,  with  certain 
dimensions,  and  interfaces  with  the  native  windowing  system  to  display  the  Button  in  the 
Java  Applet. 

The  ability  to  make  a  request  to  various  native  windowing  systems  is  handled  through 
the  java.awt.Toolkit  package.  The  java.awt.Toolkit  is  the  core  of  the  Java  VM  which  the 
AWT  uses  to  talk  with  the  native  windowing  systems.  The  java.awt.Toolkit  is  a  package 
that  creates  objects  in  the  native  display  system.  The  java.awt.Toolkit  contains  a  number 
of  methods  for  creating  "peer  objects",  between  the  Java  program  and  the  specific  native 
widowing  systems.    The  java.awt.Toolkit  is  the  one  part  of  the  Java  paradigm  "not"  fully 
portable,  but  instead  it  is  developed  for  specific  platforms.  The  java.awt.Toolkit  contains 
methods  for  making  instances  for  each  type  of  java.awt.peer  component.  As  stated 
before,  currently  this  portability  only  applies  between  Macintosh  7.5,  Motif,  and 
Windows95/NT.  However,  Sun  Microsystems  has  announced  plans  to  target  additional 
platforms. 
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Figure  E.4    A  java.awt.TooIkit  creating  a  peer  object  for  a  specific  platform 

When  a  component  such  as  a  Button,  (Figure  E.4),  is  first  created  and  displayed  to 
the  screen,  the  java.awt.Component  class  requests  a  java.awt.TooIkit  class  be  created  for 
the  corresponding  peer  object.  When  you  add  a  Button  to  a  container,  the  container  calls 
the  Button  addNotifyO  method.  The  addNotifyO  method  then  calls  the  java.awt.TooIkit 
createbutton()  method  to  make  the  Button's  peer  object  in  the  native  windowing  system. 
Therefore,  the  java.awt.Component  class  is  able  to  reference  the  native  windowing  system 
peer  object  and  call  the  peer  object  directly  !Exploring96].  Developers  normally  do  not 
directly  work  with  the  java.awt.TooIkit.  However,  there  are  a  few  instances  when 
referencing  a  java.awt.TooIkit  object  is  beneficial.    For  instance,  if  a  list  of  available  fonts, 
screen  dimensions,  or  screen  resolution,  is  needed  then  a  reference  to  the  java.awt.TooIkit 
object  is  necessary.  This  is  achieved  by  calling  the  java.awt.TooIkit  static  method 
getDefaultToolkit()  and  the  desired  methods  in  that  object.  The  use  of  the 
java.awt.TooIkit  and  its  implementation  makes  Java  programs  portable  between  all 
platforms  using  a  Java  developed  java.awt.TooIkit  interface. 
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E.     Summary 

The  Java  AWT  is  a  package  of  Java  classes  and  interfaces  allowing  the  creation  of 
window-based,  graphic  user  interface  systems.  The  AWT  provides  mechanisms  for 
graphics  display,  event  management,  text  and  graphics  primitives,  user  interface 
components,  and  cross-platform  layout.  All  of  which  make  it  impossible  to  predict  how 
extensive,  or  for  how  long,  Java  will  be  used  in  WWW,  multimedia,  and  information 
applications.  Java  is  still  in  its  infancy  and  although  it  provides  a  gentle  introduction  to 
standard  software  engineering  issues.    Java  is  currently  not  well-suited  to  perform  or 
execute  fast  animation  without  native  libraries,  large  scale  development,  text  based 
programs,  or  standalone  applications  because  of  the  cost  associated  with  the  overhead  of 
the  Java  VM  and  the  lack  of  a  MVC  model  implementation.  At  the  moment,  commercial 
applications  written  in  Java  without  native  methods  may  not  be  able  to  compete  with  other 
applications  on  the  market.  However,  in  our  opinion,  given  time,  Java's  solid  design  and 
engineering  principles  will  prove  to  be  valuable  tools  in  creating  GUI,  Object-Oriented 
Framework  applications.  Although,  the  AWT  is  considered  to  be  a  GUI  class  hierarchy, 
Sun  Microsystems  plans  to  evolve  Java  into  more  of  a  framework  that  will  better  support 
rich  applications. 

Another  issue  of  great  importance  is  Java  security.  Although  not  discussed 
sufficiently  in  this  chapter,  the  security  issues  surrounding  Java  applets/applications  while 
running  in  a  distributed  environment  need  further  attention.  These  security  concerns 
center  around  the  downloading  of  an  applet  via  the  web  and  the  potential  damage  a 
malicious  applet  could  perform  on  the  client.  In  the  current  Java  security  model  there  are 
three  fundamental  issues:  the  design  of  the  Java  language,  the  standardized  set  of  Java 
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libraries,  and  the  Web  browser  that  is  used  to  view  the  Java  applets.  Until  these  issues 
receive  further  refinement  and  a  formal  verification  of  this  model,  there  will  be  potential 
security  risks. 
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APPENDIX  E- 1  Panel  and  LayoutManager  Example  Source  Code 
import  java.applet.Applet:  import  java.awt.*: 

class  TestPanel  extends  Panel  { 

Panel  create(LayoutManager  layout)  { 
Panel  SimplePanel  =  new  Panel(): 
SimplePanel. setLayout(layout): 
SimplePanel. add("North",  new  Button("one")): 
SimplePanel.add("West",    new  Button("two")); 
SimplePanel. add("South",  new  Button("Qiree")): 
SimplePanel.add("East",    new  Button("four")): 
SimplePanel .add("Cenier".  new  Buiion('Tive")): 
return  SimplePanel; 


TestPanelO  { 

setLayout(new  CardLayoutO): 
add("one".  create(new  FlowLayoutO)): 
addC'two",  creaie(new  BorderLayoulO)): 
add("tliree".  create(new  GridLayoul(2,  2))): 
add("four",  create(new  BorderLayout(10,  10))): 
add('Tive",  create(new  FlowLayout(FlowLayout.LEFT,  10,  10))); 
add("six",  create(new  GridLayout(2,  2,  10,  10))); 
} 

public  Dimension  preferredSize(){ 
return  new  Dimension(200,  100): 
} 


public  class  PanelTest  extends  Applet  { 

TestPanel  cards: 

public  PanelTest(){ 

setLayout(new  BorderLayoulO); 
add("Center",  cards  =  new  CardPanelQ): 
Panel  SimplePanel  =  new  Panel(): 
SimplePanel. setLayout(new  FlowLayoutO): 
add("South",  SimplePanel); 
SimplePanel. add(new  Button("first")): 
SimplePanel. add(new  Buiton("next")); 
SimplePanel. add(new  Buiion("previous")): 
SimplePanel. add(new  Button("last")): 
Choice  PickOne  =  new  Choice(): 
PickOne.addItem("one"): 
PickOne.addItem("two"): 
PickOne. addltem("three"); 
PickOne.  addltem("ibur"); 
PickOne.addIiem("five"): 
SimpelPanel.add(PickOne): 
} 
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public  boolean  action(Event  evi,  Object  arg)  { 
if  (evt.target  insianceof  Choice)  { 

((CardLayout)cards.geuLayoui()).show(cards,(String)arg): 
}  else  { 
if  ("first". equals(arg))  { 

((CardLayout)cards.getLayout()).first(  cards): 
}  else  if  ("next". equals( arg))  { 

((CardLayout)cards.geiLayoutO).nexi(cards): 
}  else  if  ("previous". equals(arg))  { 

((CardLayout)cards.getLayout()).previous(cards): 
}  else  if  ("last".equals(arg))  { 

((CardLayout)cards.geiLayout()).last(cards): 
}  else  { 

((CardLayout)cards.getLayouL()).show(cards,(String)arg); 
} 
} 
retuni  true: 

} 

public  static  void  main(String  args[])  { 

Frame  a_frame  =  new  FrameC'PanelTesi"): 
PanelTest  a_panel  =  new  PanelTest(): 
a_panel.init(); 
a_panel.start(); 

a_fraine.add("Center",  a_panel): 
a_frame.resize(280,  280): 
a_fraine.show(); 

} 
} 
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APPENDIX  F  -  SOURCE  CODE  FOR  VISIBILITY  APPLET 

The  following  is  the  source  code  for  the  Visibility  example,  as  seen  in  chapter  IV. 
This  applet  demonstrates  the  scope  and  visibility  of  variables  with  in  a  Java  applet. 
Additionally,  the  sourcecode  can  be  located  at  the  web  page  address  of  http://vislab- 
www.nps.navy.mil/~java/enhanced. 
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APPENDIX  G  -  SOURCE  CODE  FOR  COURSE  SERVER 

The  Course  Server  is  a  multithreaded  application  running  on  a  computer  that 
implements  a  reliable  stream  network  connection  between  the  Course  Server  and  the 
QuestionApplet  Client  (Appendix  H). 

The  following  QuestionApplet  Client  and  Course  Server  process  diagram  is 
provided  for  further  clarification  of  the  source  code  in  Appendix  G  &  H.  The 
QuestionApplet  Client  process  and  the  Course  Server  process  are  separated  by  a  dotted 
line. 


(D 


Web  Page  Request  From  Client     .• 


Httpd  Server 


Figure  G.l.  QuestionApplet  Client  and  Course  Server  Process  Diagram 

1.  The  Web  browser  makes  a  request  to  the  Httpd  Server  which  sends 

the  Web  page,  with  the  QuestionApplet  bytecodes  in  it,  back  to  the  Web  browser.  The 
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Web  browser  then  translates  the  HTML  and  Java  bytecodes  to  create  the  Question  Applet 
Client. 

2.  The  QuestionApplet  Client  is  executed  and  builds  an  "Evaluation 
Button"  at  the  bottom  of  the  Web  Page.  This  button,  when  clicked  on,  will  create  the  Self 
Evaluation  form  for  the  lesson. 

3.  The  Course  Server  uses  the  ServerSocket  class  to  accept 
connections  from  the  QuestionApplet  Client .  When  a  QuestionApplet  Client  connects  to 
the  specified  port,  that  the  Course  Server  is  listening  on,  the  ServerSocket  allocates  a  new 
Socket  object,  and  a  separate  thread  is  created  for  the  QuestionApplet  Client  to 
communicate  with.  When  the  connection  between  the  QuestionApplet  Client  and  the 
Course  Server  is  first  established  the  QuestionApplet  Client  sends  a  stream  to  the  Course 
Server  with  a  "-1"  flag,  signifying  that  this  is  a  new  lesson,  and  the  name  of  the  lesson  file 
to  load  from  the  lesson  database. 

4.  The  Course  Server  then  parses  the  input  su-eam  that  is  sent  from 
the  QuestionApplet  Client  and  opens  the  requested  lesson  file  from  the  Lesson  Database. 
The  lesson  file  is  then  read  into  the  Course  Server  and  then  output  to  the  QuestionApplet 
Client  via  the  Java.  io.Datalnput  Stream  and  Java.  io.DataOuput  classes.  The 
java.  io.Datalnput  Stream  and  the  java.  io.DataOuput  classes  are  used  because  they 
allow  the  reading  and  writing  of  lines  of  text  and  Java  primitive  data  types  in  a  machine- 
independent  format. 

5.  The  Course  Server  then  sends  the  lesson  data  to  the 
QuestionApplet  Client  via  the  java .  io.DataOutput  class  and  returns  to  listening  for 
other  QuestionApplet  Clients  trying  to  connect. 
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6.  The  Question  Applet  Client  receives  and  parses  the  input  stream 
from  the  Course  Server.  The  QuestionApplet  Client  then  builds  the  evaluation  questions 
for  the  desired  lesson. 

7.  Once  the  user  has  completed  the  self  evaluation,  the 
QuestionApplet  Client  sends  a  stream  consisting  of  the  users  score  to  the  Course  Server, 
however  without  the  "-1"  flag. 

8.  If  the  "-1"  flag  is  not  received  by  the  Course  Server  then  the 
Course  Server  understands  that  the  data  in  the  stream  from  the  QuestionApplet  Client  is 
the  students  score  from  the  QuestionApplet  Client  self  evaluation.  The  Course  Server 
then  stores  the  score  to  the  Student  Database  and  returns  to  listening  for  other 
QuestionApplet  Clients  attempting  to  connect. 

9.  Once  the  score  has  been  sent  to  the  Course  Server  the 
QuestionApplet  uses  the  "Next.html"  field  from  the  initially  parsed  input  stream  to  request 
the  next  HTML  file  lesson  from  the  Httpd  Server.  Note  that  the  Course  Server  is 
multithreaded  and  the  Server  object  itself  is  a  thread.  This  allows  the  Course  Server  to 
loop  forever,  processing  and  listening  for  QuestionApplet  Client  requests  and  sending 
HTML  requests  to  the  Httpd  Server.  Additionally,  the  Course  Server  must  be  running 
with  a  Httpd  Server  in  parallel  else  the  QuestionApplet  Client  will  not  be  able  to  establish 
communications  with  the  Httpd  Server  nor  the  Course  Server. 
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APPENDIX  H  -  SOURCE  CODE  FOR  QUESTIONAPPLET  CLIENT 

The  QuestionApplet  Client  provides  the  GUI  for  the  enhanced  evaluation 
application  as  referenced  in  Chapter  IV.  Additionally,  the  QuestionApplet  Client  sends 
and  receives  data  from  the  Course  Server  creating  an  interactive  evaluation  form.  The 
QuestionApplet  Client  and  Course  Server  Process  diagram  in  Appendix  G  is  provided  for 
further  clarification  of  the  source  code  in  Appendix  H.  The  following  source  code  was 
implemented  to  support  the  QuestionApplet  Client  portion  of  the  enhanced  evaluation 
application. 
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